46 lines
1.8 KiB
JavaScript
46 lines
1.8 KiB
JavaScript
|
import toDate from "../toDate/index.js";
|
||
|
|
import isValid from "../isValid/index.js";
|
||
|
|
import addLeadingZeros from "../_lib/addLeadingZeros/index.js";
|
||
|
|
var days = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
|
||
|
|
var months = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
|
||
|
|
/**
|
||
|
|
* @name formatRFC7231
|
||
|
|
* @category Common Helpers
|
||
|
|
* @summary Format the date according to the RFC 7231 standard (https://tools.ietf.org/html/rfc7231#section-7.1.1.1).
|
||
|
|
*
|
||
|
|
* @description
|
||
|
|
* Return the formatted date string in RFC 7231 format.
|
||
|
|
* The result will always be in UTC timezone.
|
||
|
|
*
|
||
|
|
* @param {Date|Number} date - the original date
|
||
|
|
* @returns {String} the formatted date string
|
||
|
|
* @throws {TypeError} 1 argument required
|
||
|
|
* @throws {RangeError} `date` must not be Invalid Date
|
||
|
|
*
|
||
|
|
* @example
|
||
|
|
* // Represent 18 September 2019 in RFC 7231 format:
|
||
|
|
* const result = formatRFC7231(new Date(2019, 8, 18, 19, 0, 52))
|
||
|
|
* //=> 'Wed, 18 Sep 2019 19:00:52 GMT'
|
||
|
|
*/
|
||
|
|
|
||
|
|
export default function formatRFC7231(dirtyDate) {
|
||
|
|
if (arguments.length < 1) {
|
||
|
|
throw new TypeError("1 arguments required, but only ".concat(arguments.length, " present"));
|
||
|
|
}
|
||
|
|
|
||
|
|
var originalDate = toDate(dirtyDate);
|
||
|
|
|
||
|
|
if (!isValid(originalDate)) {
|
||
|
|
throw new RangeError('Invalid time value');
|
||
|
|
}
|
||
|
|
|
||
|
|
var dayName = days[originalDate.getUTCDay()];
|
||
|
|
var dayOfMonth = addLeadingZeros(originalDate.getUTCDate(), 2);
|
||
|
|
var monthName = months[originalDate.getUTCMonth()];
|
||
|
|
var year = originalDate.getUTCFullYear();
|
||
|
|
var hour = addLeadingZeros(originalDate.getUTCHours(), 2);
|
||
|
|
var minute = addLeadingZeros(originalDate.getUTCMinutes(), 2);
|
||
|
|
var second = addLeadingZeros(originalDate.getUTCSeconds(), 2); // Result variables.
|
||
|
|
|
||
|
|
return "".concat(dayName, ", ").concat(dayOfMonth, " ").concat(monthName, " ").concat(year, " ").concat(hour, ":").concat(minute, ":").concat(second, " GMT");
|
||
|
|
}
|