mirror of
https://github.com/denoland/deno.git
synced 2024-11-22 15:06:54 -05:00
.. | ||
formatter.ts | ||
mod.ts | ||
README.md | ||
test.ts | ||
tokenizer.ts |
datetime
Simple helper to help parse date strings into Date
, with additional functions.
Usage
The following symbols are supported:
-
yyyy
- numeric year -
yy
- 2-digit year -
M
- numeric month -
MM
- 2-digit month -
d
- numeric day -
dd
- 2-digit day -
h
- numeric hour -
hh
- 2-digit hour -
m
- numeric minute -
mm
- 2-digit minute -
s
- numeric second -
ss
- 2-digit second -
S
- 1-digit fractionalSecond -
SS
- 2-digit fractionalSecond -
SSS
- 3-digit fractionalSecond -
a
- dayPeriod, eitherAM
orPM
-
'foo'
- quoted literal -
./-
- unquoted literal
parse
Takes an input string
and a formatString
to parse to a date
.
import { parse } from 'https://deno.land/std/datetime/mod.ts'
parse("20-01-2019", "dd-MM-yyyy") // output : new Date(2019, 0, 20)
parse("2019-01-20", "yyyy-MM-dd") // output : new Date(2019, 0, 20)
parse("2019-01-20", "dd.MM.yyyy") // output : new Date(2019, 0, 20)
parse("01-20-2019 16:34", "MM-dd-yyyy hh:mm") // output : new Date(2019, 0, 20, 16, 34)
parse("01-20-2019 04:34 PM", "MM-dd-yyyy hh:mm a") // output : new Date(2019, 0, 20, 16, 34)
parse("16:34 01-20-2019", "hh:mm MM-dd-yyyy") // output : new Date(2019, 0, 20, 16, 34)
parse("01-20-2019 16:34:23.123", "MM-dd-yyyy hh:mm:ss.SSS") // output : new Date(2019, 0, 20, 16, 34, 23, 123)
...
format
Takes an input date
and a formatString
to format to a string
.
import { format } from 'https://deno.land/std/datetime/mod.ts'
format(new Date(2019, 0, 20), "dd-MM-yyyy") // output : "20-01-2019"
format(new Date(2019, 0, 20), "yyyy-MM-dd") // output : "2019-01-20"
format(new Date(2019, 0, 20), "dd.MM.yyyy") // output : "2019-01-20"
format(new Date(2019, 0, 20, 16, 34), "MM-dd-yyyy hh:mm") // output : "01-20-2019 16:34"
format(new Date(2019, 0, 20, 16, 34), "MM-dd-yyyy hh:mm a") // output : "01-20-2019 04:34 PM"
format(new Date(2019, 0, 20, 16, 34), "hh:mm MM-dd-yyyy") // output : "16:34 01-20-2019"
format(new Date(2019, 0, 20, 16, 34, 23, 123), "MM-dd-yyyy hh:mm:ss.SSS") // output : "01-20-2019 16:34:23.123"
format(new Date(2019, 0, 20), "'today:' yyyy-MM-dd") // output : "today: 2019-01-20"
...
dayOfYear / currentDayOfYear
dayOfYear()
- Returns the number of the day in the year.currentDayOfYear()
- Returns the number of the current day in the year.
import {
dayOfYear,
currentDayOfYear,
} from "https://deno.land/std/datetime/mod.ts";
dayOfYear(new Date("2019-03-11T03:24:00")); // output: 70
currentDayOfYear(); // output: ** depends on when you run it :) **
weekOfYear
Returns the ISO week number of the provided date (1-53)
import { weekOfYear } from "https://deno.land/std/datetime/mod.ts";
weekOfYear(new Date("2020-12-28T03:24:00")); // Returns 53