{"id":19621279,"url":"https://github.com/commenthol/weeknumber","last_synced_at":"2025-08-21T23:13:54.587Z","repository":{"id":50013808,"uuid":"123685450","full_name":"commenthol/weeknumber","owner":"commenthol","description":"week number systems for Gregorian year according to ISO-8601 or starting on sundays, saturdays","archived":false,"fork":false,"pushed_at":"2021-06-15T17:17:32.000Z","size":25,"stargazers_count":7,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-07T01:04:25.007Z","etag":null,"topics":["iso-8601","week","weeknumber"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/commenthol.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-03-03T11:23:31.000Z","updated_at":"2024-03-24T09:09:23.000Z","dependencies_parsed_at":"2022-09-15T18:51:18.828Z","dependency_job_id":null,"html_url":"https://github.com/commenthol/weeknumber","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/commenthol/weeknumber","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commenthol%2Fweeknumber","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commenthol%2Fweeknumber/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commenthol%2Fweeknumber/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commenthol%2Fweeknumber/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/commenthol","download_url":"https://codeload.github.com/commenthol/weeknumber/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commenthol%2Fweeknumber/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267802736,"owners_count":24146507,"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","status":"online","status_checked_at":"2025-07-30T02:00:09.044Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["iso-8601","week","weeknumber"],"created_at":"2024-11-11T11:22:13.667Z","updated_at":"2025-07-30T03:04:54.747Z","avatar_url":"https://github.com/commenthol.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# weeknumber\n\n[![NPM version](https://badge.fury.io/js/weeknumber.svg)](https://www.npmjs.com/package/weeknumber/)\n[![build status](https://secure.travis-ci.org/commenthol/weeknumber.svg?branch=master)](http://travis-ci.org/commenthol/weeknumber)\n\n\u003e week number systems for Gregorian year according to [ISO-8601][] or starting on sundays, saturdays\n\n- [API](#api)\n  - [dayOfYear](#dayofyear)\n  - [weekNumber](#weeknumber-1) - ISO 8601 week numbers\n  - [weekNumberSun](#weeknumbersun) - week starting on Sundays\n  - [weekNumberSat](#weeknumbersat) - week starting on Saturdays\n  - [weekNumberYear](#weeknumberyear) - ISO 8601 calendar year, week, and day\n  - [weekNumberYearSun](#weeknumberyearsun) - calendar year, week, and day starting on Sundays\n  - [weekNumberYearSat](#weeknumberyearsat) - calendar year, week, and day starting on Saturdays\n  - [weeksPerYear](#weeksperyear) - ISO 8601 calendar weeks in a given year\n  - [weeksPerYearSun](#weeksperyearsun)\n  - [weeksPerYearSat](#weeksperyearsat)\n- [Installation](#installation)\n- [Tests](#tests)\n- [License](#license)\n\n## API\n\n### dayOfYear\n\nGet day of year in Gregorian year\n\n**Parameters**\n\n- `date`?: Date; _optional:_ local date\n\n**Example**\n\n```js\nimport { dayOfYear } from 'weeknumber'\n\ndayOfYear(new Date(2017, 11, 31, 12))\n//\u003e 365\ndayOfYear(new Date(2018, 0, 1, 12))\n//\u003e 1\n```\n\n**Returns** `Number`, number of day in year (1 ... 366)\n\n### weekNumber\n\n[ISO-8601][] week numbering.\n\nNew week starts on Mondays.\nUsed by most European countries, most of Asia and Oceania.\n\n1st week contains 4-7 days of the new year.\n\n**Parameters**\n\n- `date`?: Date; _optional:_ local date\n\n**Example**\n\n```js\nimport { weekNumber } from 'weeknumber'\n\nweekNumber(new Date(2016, 0, 3, 12)) // Sun\n//\u003e 53\nweekNumber(new Date(2016, 0, 4, 12)) // Mon\n//\u003e 1\n```\n\n**Returns** `Number`, week number in ISO 8601 format\n\n### weekNumberSun\n\nNorth American and Islamic system.\n\nNew week starts on Sundays.\nUsed in Canada, United States, India, Japan, Taiwan, Hong Kong, Macau, Israel, South Africa, most of Latin America.\n\n1st week contains 1-7 days of the new year\n\n**Parameters**\n\n- `date`?: Date; _optional:_ local date\n\n**Example**\n\n```js\nweekNumberSun(new Date(2016, 0, 2, 12)) // Sat\n//\u003e 52\nweekNumberSun(new Date(2016, 0, 3, 12)) // Sun\n//\u003e 1\n```\n\n**Returns** `Number`, week number\n\n### weekNumberSat\n\nMiddle Eastern system.\n\nNew week starts on Saturdays.\nUsed in most of the Middle East.\n\n1st week contains 1-7 days of the new year\n\n**Parameters**\n\n- `date`?: Date; _optional:_ local date\n\n**Example**\n\n```js\nweekNumberSat(new Date(2016, 0, 1, 12)) // Fri\n//\u003e 52\nweekNumberSat(new Date(2016, 0, 2, 12)) // Sat\n//\u003e 1\n```\n\n**Returns** `Number`, week number\n\n### weekNumberYear\n\n[ISO-8601][] calendar year, week, and day\n\nNew week starts on Mondays.\nUsed by most European countries, most of Asia and Oceania.\n\n1st week contains 4-7 days of the new year.\n\n**Parameters**\n\n- `date`?: Date; _optional:_ local date\n\n**Example**\n\n```js\nweekNumberYear(new Date(2008, 11, 29, 12)) // Monday\n//\u003e { year: 2009, week: 1, day: 1 }\nweekNumberYear(new Date(2010, 0, 3, 12)) // Sunday\n//\u003e { year: 2009, week: 53, day: 7 }\n```\n\n**Returns** `Object`, `{year, week, day}` where day 1=Monday ... 7=Sunday\n\n\n### weekNumberYearSun\n\nNorth American and Islamic system calendar year, week, and day\n\nNew week starts on Sundays.\nUsed in Canada, United States, India, Japan, Taiwan, Hong Kong, Macau, Israel, South Africa, most of Latin America.\n\n1st week contains 1-7 days of the new year\n\n**Parameters**\n\n- `date`?: Date; _optional:_ local date\n\n**Example**\n\n```js\nweekNumberYearSun(new Date(2009, 0, 3, 12)) // Saturday\n//\u003e { year: 2008, week: 52, day: 7 }\nweekNumberYearSun(new Date(2009, 0, 4, 12)) // Sunday\n//\u003e { year: 2009, week: 1, day: 1 }\n```\n\n**Returns** `Object`, `{year, week, day}` where day 1=Sunday ... 7=Saturday\n\n### weekNumberYearSat\n\nMiddle Eastern system calendar year, week, and day\n\nNew week starts on Saturdays.\nUsed in most of the Middle East.\n\n1st week contains 1-7 days of the new year\n\n**Parameters**\n\n- `date`?: Date; _optional:_ local date\n\n**Example**\n\n```js\nweekNumberYearSat(new Date(2009, 0, 2, 12)) // Friday\n//\u003e { year: 2008, week: 52, day: 7 }\nweekNumberYearSat(new Date(2009, 0, 3, 12)) // Saturday\n//\u003e { year: 2009, week: 1, day: 1 }\n```\n\n**Returns** `Object`, `{year, week, day}` where day 1=Saturday ... 7=Friday\n\n### weeksPerYear\n\nISO 8601 calendar weeks in a given year\n\nNew week starts on mondays.\nUsed by most European countries, most of Asia and Oceania.\n\n**Parameters**\n\n* `year`: number;\n\nReturns **number** weeks in year\n\n### weeksPerYearSun\n\nNorth American and islamic system calendar weeks in a given year\n\nNew week starts on sundays.\nUsed in Canada, United States, India, Japan, Taiwan, Hong Kong, Macau, Israel, South Africa, most of Latin America.\n\n**Parameters**\n\n* `year`: number;\n\nReturns **number** weeks in year\n\n### weeksPerYearSat\n\nMiddle Eastern system calendar weeks in a given year\n\nNew week starts on saturdays.\nUsed in most of the Middle East.\n\n**Parameters**\n\n* `year`: number;\n\nReturns **number** weeks in year\n\n## Installation\n\nRequires [nodejs](http://nodejs.org/).\n\n```sh\n$ npm install weeknumber\n```\n\n## Tests\n\n```sh\nnpm test\n```\n\n## License\n\nUnlicense \u003chttps://unlicense.org/\u003e\n\n[ISO-8601]: https://en.wikipedia.org/wiki/ISO_8601\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcommenthol%2Fweeknumber","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcommenthol%2Fweeknumber","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcommenthol%2Fweeknumber/lists"}