deno.land / std@0.224.0 / datetime / parse.ts

View Documentation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.// This module is browser compatible.
import { DateTimeFormatter } from "./_date_time_formatter.ts";
/** * Parses a date string using the specified format string. * * The following symbols from * {@link https://www.unicode.org/reports/tr35/tr35-dates.html#Date_Field_Symbol_Table | unicode LDML} * 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 (0-23 hours) * - `HH` - 2-digit hour (00-23 hours) * - `h` - numeric hour (1-12 hours) * - `hh` - 2-digit hour (01-12 hours) * - `m` - numeric minute * - `mm` - 2-digit minute * - `s` - numeric second * - `ss` - 2-digit second * - `S` - 1-digit fractional second * - `SS` - 2-digit fractional second * - `SSS` - 3-digit fractional second * - `a` - dayPeriod, either `AM` or `PM` * - `'foo'` - quoted literal * - `./-` - unquoted literal * * @param dateString The date string to parse. * @param formatString The date time string format. * @return The parsed date. * * @example Basic usage * ```ts * import { parse } from "https://deno.land/std@$STD_VERSION/datetime/parse.ts"; * * parse("20-01-2019", "dd-MM-yyyy"); // 2019-01-19T13:00:00.000Z * * parse("01-20-2019 04:34 PM", "MM-dd-yyyy hh:mm a"); // 2019-01-20T05:34:00.000Z * * parse("01-20-2019 16:34:23.123", "MM-dd-yyyy HH:mm:ss.SSS"); // 2019-01-20T05:34:23.123Z * ``` */export function parse(dateString: string, formatString: string): Date { const formatter = new DateTimeFormatter(formatString); const parts = formatter.parseToParts(dateString); const sortParts = formatter.sortDateTimeFormatPart(parts); return formatter.partsToDate(sortParts);}
std

Version Info

Tagged at
6 months ago