Date API
An ISO date, validity, and Unix timestamp.
Pass a date the way a spreadsheet, a form, or a log wrote it. 2026-03-29, March 29, 2026, 29 Aug 2026, 3/29/2026, and 20260829 all come back as one clean answer: normalized ISO date, validity and Unix time. Paid plans include calendar components, weekday, ISO week, quarter and leap-year detail. A leading weekday and an ISO time tail are ignored.
Junk answers valid: false as a 200, never a 404. Bare GET /date answers today in UTC.
ParseCopy link
GET /date/{date}API Explorer ↗Normalized ISO date, validity and Unix time
Parameters
- datestring · path · required
The date as you have it
- formatstring · query · optional
mdy or dmy. Breaks the tie on numeric dates where both readings are real days (03/04/2026). Applies to to= as well
Values:
mdy, dmy- tostring · query · optional
Another date. Appends to (normalized ISO) and days (signed days between)
- langstring · query · optional
Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.
Length: 2 to 64 characters
import { parseAPI } from '@parseapi/sdk';
const parse = parseAPI("YOUR_API_KEY");
const result = await parse.date("March 29, 2026");
console.log(result);{
"date": "2026-03-29",
"valid": true,
"unix": 1774742400,
"year": 2026,
"month": 3,
"month_name": "March",
"day": 29,
"weekday": 7,
"weekday_name": "Sunday",
"week": 13,
"week_year": 2026,
"day_of_year": 88,
"quarter": 1,
"leap": false,
"days_in_month": 31
}Response fields
- dateLink to datestring
- The date as ISO YYYY-MM-DD, or the input echoed when it does not parse
- validLink to validboolean
- Resolves to one real calendar day. Ambiguous numeric dates answer false without ?format=
- unixLink to unixinteger or null
- Unix time at midnight UTC of that date, seconds
- toLink to tostring
- With ?to= only: the other date, normalized ISO
- daysLink to daysinteger or null
- With ?to= only: signed days from the date to ?to=. Future positive, past negative
Today in UTCCopy link
GET /dateAPI Explorer ↗Today in UTC, with optional days to another date
Parameters
- tostring · query · optional
Another date. Appends to and days (signed days from today)
- langstring · query · optional
Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.
Length: 2 to 64 characters
No date input is needed. Use ?to=2026-12-25 to include the signed number of days from today to another date. The response uses the same date fields as Parse above.
Ambiguous datesCopy link
3/29/2026 resolves on its own, 29 cannot be a month. 03/04/2026 could be March 4th or April 3rd, so it answers valid: false until ?format=mdy or ?format=dmy asserts a reading. Two-digit years never resolve.
import { parseAPI } from '@parseapi/sdk';
const parse = parseAPI("YOUR_API_KEY");
const result = await parse.date("03/04/2026");
console.log(result);{
"date": "03/04/2026",
"valid": false,
"unix": null,
"year": null,
"month": null,
"month_name": null,
"day": null,
"weekday": null,
"weekday_name": null,
"week": null,
"week_year": null,
"day_of_year": null,
"quarter": null,
"leap": null,
"days_in_month": null
}Days betweenCopy link
Add ?to= with another date. The response appends to, normalized ISO, and days, signed, so a past date goes negative. Bare /date?to=2026-12-25 is days until Christmas.
import { parseAPI } from '@parseapi/sdk';
const parse = parseAPI("YOUR_API_KEY");
const result = await parse.date("2026-08-29", { to: "2026-12-25" });
console.log(result);{
"date": "2026-08-29",
"valid": true,
"unix": 1787961600,
"to": "2026-12-25",
"days": 118,
"year": 2026,
"month": 8,
"month_name": "August",
"day": 29,
"weekday": 6,
"weekday_name": "Saturday",
"week": 35,
"week_year": 2026,
"day_of_year": 241,
"quarter": 3,
"leap": false,
"days_in_month": 31
}Included dataCopy link
Calendar components, ISO week, quarter and leap-year detail. Included automatically on paid plans in API 2.2. Existing accounts retain their current profile access.
Paid plan fields
- yearLink to yearinteger or null
- Year
- monthLink to monthinteger or null
- Month, 1 to 12
- month_nameLink to month_namestring or null
- English month name
- dayLink to dayinteger or null
- Day of month
- weekdayLink to weekdayinteger or null
- ISO weekday, Monday 1 to Sunday 7
- weekday_nameLink to weekday_namestring or null
- English weekday name
- weekLink to weekinteger or null
- ISO 8601 week number
- week_yearLink to week_yearinteger or null
- The year that ISO week belongs to. Differs from year around January 1
- day_of_yearLink to day_of_yearinteger or null
- Day of year, 1 to 366
- quarterLink to quarterinteger or null
- Quarter, 1 to 4
- leapLink to leapboolean or null
- Whether the year is a leap year
- days_in_monthLink to days_in_monthinteger or null
- Days in that month
Display languageCopy link
Pass lang with a language tag such as fr, pt-BR, or zh-Hant. Requested month_name and weekday_name, covering all 12 Gregorian months and 7 weekdays. Date parsing and formatted date strings stay unchanged.
Omitting lang preserves the original response. Codes, IDs, numeric facts and native-name fields stay unchanged. Missing translations keep their existing source value; unknown values stay null. A preserved name_local may equal the translated name.
Send a chosen browser preference explicitly, for example { lang: navigator.language } in your JavaScript SDK options. The API does not read Accept-Language automatically. Unsupported regions fall back to their supported base language; unsupported languages or scripts use English. Empty, invalid or repeated tags return 400.
Content-Language identifies languages used in translated display fields and known English fallbacks. Display language is available on API 2.1.0; requests selecting frozen 1.0.0 retain their original contract. See API versions.
33 display language choices
| Language tag | Language |
|---|---|
| en | English |
| ar | العربية |
| ca | català |
| hr | hrvatski |
| cs | čeština |
| da | dansk |
| nl | Nederlands |
| fi | suomi |
| fr | français |
| de | Deutsch |
| el | Ελληνικά |
| he | עברית |
| hi | हिन्दी |
| hu | magyar |
| id | Indonesia |
| it | italiano |
| ja | 日本語 |
| ko | 한국어 |
| ms | Melayu |
| nb | norsk bokmål |
| pl | polski |
| pt | português |
| ro | română |
| ru | русский |
| zh-Hans | 简体中文 |
| sk | slovenčina |
| es | español |
| sv | svenska |
| th | ไทย |
| zh-Hant | 繁體中文 |
| tr | Türkçe |
| uk | українська |
| vi | Tiếng Việt |