Help language development. Donate to The Perl Foundation

Games::TauStation::DateTime zef:raku-community-modules last updated on 2022-05-20


Actions Status


Games::TauStation::DateTime — Convert TauStation's Galactic Coordinated Time to Old Earth Time


use Games::TauStation::DateTime;

# Show time in GCT or Old Earth time:
say'193.99/59:586 GCT');    # OUTPUT: «193.99/59:586 GCT␤»
say'193.99/59:586 GCT').OE; # OUTPUT: «2017-03-03T16:00:32.229148Z␤»

# Show duration from now:
say'D12/43:044 GCT');    # OUTPUT: «198.27/19:285 GCT␤»
say'D12/43:044 GCT').OE; # OUTPUT: «2018-05-05T06:20:12.543815Z␤»

# Adjust date using GCT or Old Earth time units:
say'193.99/59:586 GCT').later(:30segments).earlier(:2hours);
# OUTPUT: «193.99/81:253 GCT␤»

# We inherit from DateTime class:
say'2018-04-03T12:20:43Z');    # OUTPUT: «197.95/44:321 GCT␤»
say'193.99/59:586 GCT').posix; # OUTPUT: «1488556832␤»


This module implements a subclass of DateTime that lets you convert times between TauStation's Galactic Coordinated Time (GCT) and Old Earth (i.e. "real life") time.



Inherits all methods from DateTime


multi method new(Str:D $ where /<gct-time>/ --> GCT:D);
multi method new(Str:D $ where /<gct-duration>/ --> GCT:D);

In addition to regular DateTime constructors, two new ones are provided that take a string with either a GCT time or GCT duration, which is similar to time, except it's prefixed with uppercase letter D (see CORETECHS archive for details).

Negative times and durations are allowed. For durations, the minus sign goes after letter D Cycle and day units may be omitted. When cycle is omitted, the dot that normally follows it must be omitted as well; when both cycle and day are omitted, the slash before the time must be present. Whitespace can be used between units and separators.

These are examples of valid times:

These are examples of valid durations:

OE / OldEarth

say'D12/43:044 GCT');          # OUTPUT: «198.27/19:285 GCT␤»
say'D12/43:044 GCT').OE;       # OUTPUT: «2018-05-05T06:20:12.543815Z␤»
say'D12/43:044 GCT').OldEarth; # OUTPUT: «2018-05-05T06:20:12.543815Z␤»

.OE is an alias for .OldEarth. The methods don't take any arguments and return a cloned GCT object with .formatter set to the default DateTime formatter (i.e. the date when printed would be printed as Old Earth time instead of GCT).


say'D12/43:044 GCT').DateTime;       # OUTPUT: «2018-05-05T06:29:14.494109Z␤»
say'D12/43:044 GCT').DateTime.^name; # OUTPUT: «DateTime␤»

Coerces a GCT object to plain DateTime object.


Zoffix Znet


Copyright 2017 Zoffix Znet

Copyright 2018 - 2022 Raku Community

This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.