Files
Letter NandGitHub 37c6a7d1fc time, is it really that time (#7482)
<!-- Write **BELOW** The Headers and **ABOVE** The comments else it may
not be viewable. -->
<!-- You can view Contributing.MD for a detailed description of the pull
request process. -->

## About The Pull Request
update time related procs & glob too (i was originally targeting that
lmao).
also **stop** using byondtime for sql stuff, we have `NOW()`!!
<!-- Describe The Pull Request. Please be sure every change is
documented or this can delay review and even discourage maintainers from
merging your PR! -->

## Why It's Good For The Game

<!-- Argue for the merits of your changes and how they benefit the game,
especially if they are controversial and/or far reaching. If you can't
actually explain WHY what you are doing will improve the game, then it
probably isn't good for the game in the first place. -->

## Changelog

<!-- If your PR modifies aspects of the game that can be concretely
observed by players or admins you should add a changelog. If your change
does NOT meet this description, remove this section. Please note that
maintainers freely reserve the right to remove and add tags should they
deem it appropriate. You can attempt to finagle the system all you want,
but it's best to shoot for clear communication right off the bat. -->

<!-- Both 🆑's are required for the changelog to work! You can put
your name to the right of the first 🆑 if you want to overwrite your
GitHub username as author ingame. -->
<!-- You can use multiple of the same prefix (they're only used for the
icon ingame) and delete the unneeded ones. Despite some of the tags,
changelogs should generally represent how a player might be affected by
the changes rather than a summary of the PR's contents. -->
2026-01-13 22:06:30 -05:00

100 lines
3.8 KiB
Plaintext

//* This file is explicitly licensed under the MIT license. *//
//* Copyright (c) 2025 Citadel Station Developers *//
/**
* # SStime_keep
*
* Centralized time-keeping subsystem for world & in-game time.
*
* * Linux broke our clock, instead of figuring out why
* I'm going to fix this by doing what I do best:
* needlessly refactoring code.
* * Galactic date is the IRL date plus a given number of years.
* * Galactic time is a random hour, usually, plus time from server boot.
* * Galactic time is affected by time dilation, unlike timeofday/realtimeofday.
*/
SUBSYSTEM_DEF(time_keep)
name = "Time Keeping"
subsystem_flags = SS_NO_FIRE | SS_NO_INIT
var/galactic_year_offset = STATION_YEAR_OFFSET
var/static/galactic_time_offset = null
var/list/possible_roundstart_offsets = list(
2 HOURS,
7 HOURS,
12 HOURS,
17 HOURS,
)
var/tmp/cached_galactic_date
var/tmp/cached_galactic_date_rollovers
/// approximate REALTIMEOFDAY we booted at
/// * Set by PreInit, which is very close, but not precisely, at server boot.
var/static/cached_server_boot_rtod
/// world.time we started the round at
/// * Null until round starts.
var/static/cached_round_start_time
/// REALTIMEOFDAY we started the round at
/// * Null until round starts.
var/static/cached_round_start_rtod
/datum/controller/subsystem/time_keep/PreInit(recovering)
if(isnull(galactic_time_offset))
galactic_time_offset = pick(possible_roundstart_offsets)
cached_server_boot_rtod = REALTIMEOFDAY
return ..()
/**
* @return as YYYY-MM-DD
*/
/datum/controller/subsystem/time_keep/proc/render_galactic_date(manual_offset)
// Note: midnight rollovers have to be subtracted because we manually track midnight rollovers
// in date rendering code.
MIDNIGHT_ROLLOVER_CHECK_STANDALONE
if(manual_offset)
var/use_time = galactic_time_offset + manual_offset - (GLOB.midnight_rollovers DAYS)
return "[num2text(time2text(use_time, "YYYY", NO_TIMEZONE)) + galactic_year_offset]-[time2text(use_time, "MM-DD", NO_TIMEZONE)]"
else
var/use_time = galactic_time_offset + world.time - (GLOB.midnight_rollovers DAYS)
var/rollovers = floor(use_time / (1 DAY))
if(rollovers != cached_galactic_date_rollovers)
cached_galactic_date = "[text2num(time2text(use_time, "YYYY", NO_TIMEZONE)) + galactic_year_offset]-[time2text(use_time, "MM-DD", NO_TIMEZONE)]"
return cached_galactic_date
/**
* Returns time from start of current round. Default offset is current time.
* @return as hh:mm:ss
*/
/datum/controller/subsystem/time_keep/proc/render_galactic_time(manual_offset)
if(manual_offset)
// TODO: slow path that doesn't cache
return time2text(galactic_time_offset + manual_offset, "hh:mm:ss", NO_TIMEZONE)
else
// TODO: cache fast path
return time2text(galactic_time_offset + world.time, "hh:mm:ss", NO_TIMEZONE)
/**
* Returns time from start of current round. Default offset is current time.
* @return as hh:mm
*/
/datum/controller/subsystem/time_keep/proc/render_galactic_time_short(manual_offset)
if(manual_offset)
// TODO: slow path that doesn't cache
return time2text(galactic_time_offset + manual_offset, "hh:mm", NO_TIMEZONE)
else
// TODO: cache fast path
return time2text(galactic_time_offset + world.time, "hh:mm", NO_TIMEZONE)
/**
* * **warning**: this proc return should never be used to render date. BYOND is weird.
* @return deciseconds into the current day we started the server at.
* Value will only make sense when time2text'd to `hh`, `mm`, `ss` format.
* Date formats will fail miserably due to us using `world.time` instead of `world.realtime` for floating
* point accuracy reasons. Make sure you remember to set timezone to `0` in `time2text` if using this
* for that.
*/
/datum/controller/subsystem/time_keep/proc/get_galactic_time_offset()
return galactic_time_offset