mirror of
https://github.com/denoland/std.git
synced 2024-11-21 20:50:22 +00:00
58 lines
1.9 KiB
TypeScript
58 lines
1.9 KiB
TypeScript
// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
|
|
// This module is browser compatible.
|
|
|
|
import { DAY } from "./constants.ts";
|
|
|
|
/**
|
|
* Returns the number of the day in the year in the local time zone.
|
|
*
|
|
* @param date Date to get the day of the year of.
|
|
* @return Number of the day in the year in the local time zone.
|
|
*
|
|
* @example Basic usage
|
|
* ```ts
|
|
* import { dayOfYear } from "@std/datetime/day-of-year";
|
|
* import { assertEquals } from "@std/assert";
|
|
*
|
|
* assertEquals(dayOfYear(new Date("2019-03-11T03:24:00")), 70);
|
|
* ```
|
|
*/
|
|
export function dayOfYear(date: Date): number {
|
|
// Values from 0 to 99 map to the years 1900 to 1999. All other values are the actual year. (https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/Date)
|
|
// Using setFullYear as a workaround
|
|
|
|
const yearStart = new Date(date);
|
|
|
|
yearStart.setFullYear(date.getFullYear(), 0, 0);
|
|
const diff = (date.getTime() - date.getTimezoneOffset() * 60 * 1000) -
|
|
(yearStart.getTime() - yearStart.getTimezoneOffset() * 60 * 1000);
|
|
|
|
return Math.floor(diff / DAY);
|
|
}
|
|
|
|
/**
|
|
* Returns the number of the day in the year in UTC time.
|
|
*
|
|
* @param date Date to get the day of the year of.
|
|
* @return Number of the day in the year in UTC time.
|
|
*
|
|
* @example Usage
|
|
* ```ts
|
|
* import { dayOfYearUtc } from "@std/datetime/day-of-year";
|
|
* import { assertEquals } from "@std/assert";
|
|
*
|
|
* assertEquals(dayOfYearUtc(new Date("2019-03-11T03:24:00.000Z")), 70);
|
|
* ```
|
|
*/
|
|
export function dayOfYearUtc(date: Date): number {
|
|
// Values from 0 to 99 map to the years 1900 to 1999. All other values are the actual year. (https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/Date)
|
|
// Using setUTCFullYear as a workaround
|
|
|
|
const yearStart = new Date(date);
|
|
|
|
yearStart.setUTCFullYear(date.getUTCFullYear(), 0, 0);
|
|
const diff = date.getTime() - yearStart.getTime();
|
|
|
|
return Math.floor(diff / DAY);
|
|
}
|