value

gen:datetime-provider :any/c

In fact, gen:datetime-provider is also implemented by date , which can be treated like a datetime with its time component set to midnight. This should be considered an experimental part of the design, which may be removed.

procedure

( datetime-provider? x)→boolean?

x:any/c

procedure

( ->datetime/local t)→datetime?

t:datetime-provider?

> (->datetime/local (datetime 1969721256))

#<datetime 1969年07月21日T02:56:00>

> (->datetime/local (moment 2015381#:tz"America/New_York"))

#<datetime 2015年03月08日T01:00:00>

procedure

( ->datetime/utc t)→datetime?

t:datetime-provider?

> (->datetime/utc (datetime 1969721256))

#<datetime 1969年07月21日T02:56:00>

> (->datetime/utc (moment 2015381#:tz"America/New_York"))

#<datetime 2015年03月08日T06:00:00>

procedure

( ->posix t)→rational?

t:datetime-provider?

> (->posix (datetime 1970))

0

> (->posix (moment 2015381#:tz"America/New_York"))

1425794400

procedure

( ->jd t)→rational?

t:datetime-provider?

> (->jd (moment -4713112412#:tz"Etc/UTC"))

0

> (->jd (datetime 1970))

4881175/2

procedure

( years-between t1t2)→exact-integer?

t1:datetime-provider?

t2:datetime-provider?

procedure

( months-between t1t2)→exact-integer?

t1:datetime-provider?

t2:datetime-provider?

procedure

( weeks-between t1t2)→exact-integer?

t1:datetime-provider?

t2:datetime-provider?

procedure

( days-between t1t2)→exact-integer?

t1:datetime-provider?

t2:datetime-provider?

procedure

( hours-between t1t2)→exact-integer?

t1:datetime-provider?

t2:datetime-provider?

procedure

( minutes-between t1t2)→exact-integer?

t1:datetime-provider?

t2:datetime-provider?

procedure

( seconds-between t1t2)→exact-integer?

t1:datetime-provider?

t2:datetime-provider?

procedure

( milliseconds-between t1t2)→exact-integer?

t1:datetime-provider?

t2:datetime-provider?

procedure

( microseconds-between t1t2)→exact-integer?

t1:datetime-provider?

t2:datetime-provider?

procedure

( nanoseconds-between t1t2)→exact-integer?

t1:datetime-provider?

t2:datetime-provider?

> (years-between (datetime 2000)(datetime 2001))

1

> (years-between (datetime 2001)(datetime 2002))

1

> (months-between (datetime 20003)(datetime 199912))

-3

> (days-between (moment 201538159#:tz"America/Los_Angeles")

(moment 2015316159#:tz"America/Los_Angeles"))

8

> (weeks-between (moment 201538159#:tz"America/Los_Angeles")

(moment 2015316159#:tz"Etc/UTC"))

1

> (days-between (datetime 2015)(datetime 2015114235959))

13

> (hours-between (moment 2000#:tz"Etc/UTC")

(moment 1999123119#:tz"America/New_York"))

0

> (minutes-between (datetime 2000)(datetime 200012))

1440

> (seconds-between (datetime 2000)(datetime 200012))

86400

> (milliseconds-between (datetime 2000)(datetime 200012))

86400000

> (microseconds-between (datetime 2000)(datetime 200012))

86400000000

> (nanoseconds-between (datetime 2000)(datetime 200012))

86400000000000

procedure

( with-timezone t

tz

#:resolve-offsetresolve-offset)

→moment-provider?

t:datetime-provider?

tz:tz/c

resolve-offset:offset-resolver/c

This function is a blunt instrument and is rarely needed. If your aim is to translate a moment into another that represents the same point in absolute time but in a different time zone, then you’re looking for adjust-timezone .

> (with-timezone (datetime 2000)"America/New_York")

#<moment 2000年01月01日T00:00:00-05:00[America/New_York]>

> (with-timezone (moment 2000#:tz"America/New_York")"Europe/Paris")

#<moment 2000年01月01日T00:00:00+01:00[Europe/Paris]>