@@ -14,12 +14,19 @@ interface system-clock {
14
14
/// An "instant", or "exact time", is a point in time without regard to any
15
15
/// time zone: just the time since a particular external reference point,
16
16
/// often called an "epoch".
17
+ ///
18
+ /// Here, the epoch is 1970-01-01T00:00:00Z, also known as
19
+ /// [POSIX's Seconds Since the Epoch], also known as [Unix Time].
20
+ ///
17
21
/// Note that even if the seconds field is negative, incrementing
18
22
/// nanoseconds always represents moving forwards in time.
19
23
/// For example, `{ -1 seconds, 999999999 nanoseconds }` represents the
20
24
/// instant one nanosecond before the epoch.
21
25
/// For more on various different ways to represent time, see
22
26
/// https://tc39.es/proposal-temporal/docs/timezone.html
27
+ ///
28
+ /// [POSIX's Seconds Since the Epoch]: https://pubs.opengroup.org/onlinepubs/9699919799/xrat/V4_xbd_chap04.html#tag_21_04_16
29
+ /// [Unix Time]: https://en.wikipedia.org/wiki/Unix_time
23
30
@since (version = 0.3.0-rc-2025-08-15 )
24
31
record instant {
25
32
seconds : s64 ,
@@ -38,14 +45,7 @@ interface system-clock {
38
45
/// This clock is not monotonic, therefore calling this function repeatedly
39
46
/// will not necessarily produce a sequence of non-decreasing values.
40
47
///
41
- /// The returned timestamps represent the number of seconds since
42
- /// 1970-01-01T00:00:00Z, also known as [POSIX's Seconds Since the Epoch],
43
- /// also known as [Unix Time].
44
- ///
45
48
/// The nanoseconds field of the output is always less than 1000000000.
46
- ///
47
- /// [POSIX's Seconds Since the Epoch]: https://pubs.opengroup.org/onlinepubs/9699919799/xrat/V4_xbd_chap04.html#tag_21_04_16
48
- /// [Unix Time]: https://en.wikipedia.org/wiki/Unix_time
49
49
@since (version = 0.3.0-rc-2025-08-15 )
50
50
now : func () -> instant ;
51
51
0 commit comments