Skip to main content

Time

Time.getServerTime(): Promise<number>​

Returns the current server time as a Unix timestamp in seconds.

const now = await Time.getServerTime();

Time.getServerDate(timezone?): Promise<CastleDateParts>​

Returns the current server time broken into date parts. timezone is 'Castle' (default; Castle's server timezone, same for every player) or 'player' (the player's local timezone).

The returned CastleDateParts has:

  • sec, min, hour — time of day.
  • day (1-31), month (1-12), year — date.
  • wday — day of the week (1-7, Sunday = 1).
  • yday — day of the year (1-366).
  • daysSinceCastleEpoch — a day number that increments every day. Use it for daily content.
const date = await Time.getServerDate("player");
const dailyPuzzle = (date.daysSinceCastleEpoch % 30) + 1;