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

Example

Request

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.date("March 29, 2026");
console.log(result);
Example responsePaid plan
{
  "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

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.

Request

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.date("03/04/2026");
console.log(result);
Example responsePaid plan
{
  "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.

Request

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);
Example responsePaid plan
{
  "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 tagLanguage
enEnglish
arالعربية
cacatalà
hrhrvatski
csčeština
dadansk
nlNederlands
fisuomi
frfrançais
deDeutsch
elΕλληνικά
heעברית
hiहिन्दी
humagyar
idIndonesia
ititaliano
ja日本語
ko한국어
msMelayu
nbnorsk bokmål
plpolski
ptportuguês
roromână
ruрусский
zh-Hans简体中文
skslovenčina
esespañol
svsvenska
thไทย
zh-Hant繁體中文
trTürkçe
ukукраїнська
viTiếng Việt