import { addLeadingZeros } from "./_lib/addLeadingZeros.js"; import { isValid } from "./isValid.js"; import { toDate } from "./toDate.js"; /** * The {@link formatRFC3339} function options. */ /** * @name formatRFC3339 * @category Common Helpers * @summary Format the date according to the RFC 3339 standard (https://tools.ietf.org/html/rfc3339#section-5.6). * * @description * Return the formatted date string in RFC 3339 format. Options may be passed to control the parts and notations of the date. * * @param date - The original date * @param options - An object with options. * * @returns The formatted date string * * @throws `date` must not be Invalid Date * * @example * // Represent 18 September 2019 in RFC 3339 format: * formatRFC3339(new Date(2019, 8, 18, 19, 0, 52)) * //=> '2019-09-18T19:00:52Z' * * @example * // Represent 18 September 2019 in RFC 3339 format, 3 digits of second fraction * formatRFC3339(new Date(2019, 8, 18, 19, 0, 52, 234), { * fractionDigits: 3 * }) * //=> '2019-09-18T19:00:52.234Z' */ export function formatRFC3339(date, options) { const date_ = toDate(date, options?.in); if (!isValid(date_)) { throw new RangeError("Invalid time value"); } const fractionDigits = options?.fractionDigits ?? 0; const day = addLeadingZeros(date_.getDate(), 2); const month = addLeadingZeros(date_.getMonth() + 1, 2); const year = date_.getFullYear(); const hour = addLeadingZeros(date_.getHours(), 2); const minute = addLeadingZeros(date_.getMinutes(), 2); const second = addLeadingZeros(date_.getSeconds(), 2); let fractionalSecond = ""; if (fractionDigits > 0) { const milliseconds = date_.getMilliseconds(); const fractionalSeconds = Math.trunc( milliseconds * Math.pow(10, fractionDigits - 3), ); fractionalSecond = "." + addLeadingZeros(fractionalSeconds, fractionDigits); } let offset = ""; const tzOffset = date_.getTimezoneOffset(); if (tzOffset !== 0) { const absoluteOffset = Math.abs(tzOffset); const hourOffset = addLeadingZeros(Math.trunc(absoluteOffset / 60), 2); const minuteOffset = addLeadingZeros(absoluteOffset % 60, 2); // If less than 0, the sign is +, because it is ahead of time. const sign = tzOffset < 0 ? "+" : "-"; offset = `${sign}${hourOffset}:${minuteOffset}`; } else { offset = "Z"; } return `${year}-${month}-${day}T${hour}:${minute}:${second}${fractionalSecond}${offset}`; } // Fallback for modularized imports: export default formatRFC3339;