{"id":24755177,"url":"https://github.com/gravity-ui/date-utils","last_synced_at":"2026-02-19T12:07:05.758Z","repository":{"id":65343902,"uuid":"588619520","full_name":"gravity-ui/date-utils","owner":"gravity-ui","description":"Helpers to manage work with dates.","archived":false,"fork":false,"pushed_at":"2024-11-21T11:18:22.000Z","size":593,"stargazers_count":11,"open_issues_count":2,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-25T16:32:10.278Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gravity-ui.png","metadata":{"files":{"readme":"README-ru.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-01-13T15:11:21.000Z","updated_at":"2024-11-21T11:17:42.000Z","dependencies_parsed_at":"2023-02-16T23:31:26.831Z","dependency_job_id":"d24f6ff2-f147-48d2-ad0a-f1114fba9a69","html_url":"https://github.com/gravity-ui/date-utils","commit_stats":null,"previous_names":[],"tags_count":24,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gravity-ui%2Fdate-utils","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gravity-ui%2Fdate-utils/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gravity-ui%2Fdate-utils/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gravity-ui%2Fdate-utils/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gravity-ui","download_url":"https://codeload.github.com/gravity-ui/date-utils/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235700132,"owners_count":19031671,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-28T12:36:50.218Z","updated_at":"2025-10-11T01:31:27.191Z","avatar_url":"https://github.com/gravity-ui.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# @gravity-ui/date-utils\n\nУтилиты для управления датой и временем.\n\n## Установка\n\n```shell\nnpm i @gravity-ui/date-utils\n```\n\n## Использование\n\n```typescript\nimport {dateTimeParse, dateTime} from '@gravity-ui/date-utils';\n\n// Current date: 2021-08-07T12:10:00\n// User's time zone: Europe/Istanbul\n\nconst FORMAT = 'YYYY-MM-DDTHH:mm:ssZ';\n\n// parse absolute date\ndateTimeParse({year: 2021, month: 7, day: 7})?.format(FORMAT); // \"2021-08-07T00:00:00+03:00\"\ndateTimeParse([2021, 7, 7])?.format(FORMAT); // \"2021-08-07T00:00:00+03:00\"\ndateTimeParse('2021-08-07')?.format(FORMAT); // \"2021-08-07T00:00:00+03:00\"\ndateTimeParse(1621708204063)?.format(FORMAT); // \"2021-05-22T21:30:04+03:00\"\ndateTimeParse('')?.format(FORMAT); // undefined\ndateTimeParse('incorrect-date')?.format(FORMAT); // undefined\n\n// parse relative date\ndateTimeParse('now')?.format(FORMAT); // \"2021-08-07T12:10:00+03:00\"\ndateTimeParse('now-1d')?.format(FORMAT); // \"2021-08-06T12:10:00+03:00\"\ndateTimeParse('now-1d+1M')?.format(FORMAT); // \"2021-09-06T12:10:00+03:00\"\ndateTimeParse('now/d')?.format(FORMAT); // \"2021-08-07T00:00:00+03:00\"\ndateTimeParse('now+1d/d')?.format(FORMAT); // \"2021-08-08T00:00:00+03:00\"\ndateTimeParse('now-1f')?.format(FORMAT); // undefined\n\n// create dateTime\ndateTime().format(FORMAT); // \"2021-08-07T12:10:00+03:00\"\ndateTime({input: '2021-08-07'}).format(FORMAT); // \"2021-08-07T00:00:00+03:00\"\ndateTime({input: '2021-08-07', format: 'YYYY-MM-DD'}).format(FORMAT); // \"2021-08-07T00:00:00+03:00\"\ndateTime({timeZone: 'Asia/Tokyo'}).format(FORMAT); // \"2021-08-07T18:10:00+09:00\ndateTime({input: ''}).format(FORMAT); // \"Invalid Date\"\ndateTime({input: '2021-08', format: 'YYYY-MM-DD'}).format(FORMAT); // \"Invalid Date\"\n```\n\n## Настройки\n\n```typescript\nimport {settings} from '@gravity-ui/date-utils';\n\n// Locales management\nsettings.getLocale(); // default locale \"en\"\nsettings.loadLocale('de').then(() =\u003e {\n  settings.setLocale('de');\n  settings.getLocale(); // \"de\"\n});\n\n// Customization\nsettings.updateLocale({weekStart: 0}); // change first day of week\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgravity-ui%2Fdate-utils","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgravity-ui%2Fdate-utils","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgravity-ui%2Fdate-utils/lists"}