{"id":24716972,"url":"https://github.com/scottstraughan/ngx-simple-date-picker","last_synced_at":"2026-01-04T22:41:13.846Z","repository":{"id":201354907,"uuid":"707303409","full_name":"scottstraughan/ngx-simple-date-picker","owner":"scottstraughan","description":"A simple-to-use date picker component for use in Angular (ngx) projects.","archived":false,"fork":false,"pushed_at":"2023-10-26T10:58:13.000Z","size":911,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-02-27T12:41:45.001Z","etag":null,"topics":["angular","angular2","date-picker","ngx","typescript"],"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/scottstraughan.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,"governance":null,"roadmap":null,"authors":null}},"created_at":"2023-10-19T16:08:50.000Z","updated_at":"2025-01-24T11:16:28.000Z","dependencies_parsed_at":"2023-12-26T11:20:07.742Z","dependency_job_id":null,"html_url":"https://github.com/scottstraughan/ngx-simple-date-picker","commit_stats":null,"previous_names":["e73b025/ngx-easy-date-picker","e73b025/ngx-simple-date-picker","scottstraughan/ngx-simple-date-picker"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scottstraughan%2Fngx-simple-date-picker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scottstraughan%2Fngx-simple-date-picker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scottstraughan%2Fngx-simple-date-picker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scottstraughan%2Fngx-simple-date-picker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/scottstraughan","download_url":"https://codeload.github.com/scottstraughan/ngx-simple-date-picker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244937833,"owners_count":20535127,"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":["angular","angular2","date-picker","ngx","typescript"],"created_at":"2025-01-27T09:44:33.027Z","updated_at":"2026-01-04T22:41:13.815Z","avatar_url":"https://github.com/scottstraughan.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NGX Date Picker\n\nA simple-to-use date picker component for use in Angular (ngx) projects. This component provides your users the ability\nto select a date or a date range using a clean, sharp looking popup user interface.\n\n![Screenshot](./src/assets/screenshot.png)\n\n## Features\n\n- No external dependencies\n- Provides either the ability to use the picker UI directly or via a date picker input field\n- Built in light/dark mode\n- Easy to override configuration\n- Easy to override styling\n\n## Demo\n\n[Click here to view available demos](https://e73b025.github.io/ngx-simple-date-picker/)\n\n## Using the Input Component (easiest)\n\n### How To Use\n\nIf you wish to show an input component that will allow your uses to select a date or date range, use the following\ncode:\n\n**In your template:**\n\n```html\n\u003cngx-date-picker-input [(date)]=\"dateSelection\" (dateChange)=\"onDateChanges()\"\u003e\u003c/ngx-date-picker-input\u003e\n\u003cdiv\u003e{{dateSelection | json}}\u003c/div\u003e\n```\n\n**In your component:**\n\n```typescript\n@Component({\n  templateUrl: './example.component.html',\n  styleUrls: ['./example.component.scss']\n})\nexport class ExampleComponent {\n    dateSelection: DateSelection | undefined\n\n  onDateChanges() {\n    console.log(this.dateSelection);\n  }\n}\n```\n\nThe `dateSelection` property uses a two-way binding, so you can either bind it directly to your template\nor perform an action within the `onDateChanges()` method above.\n\n### Configuration\n\nYou can configure both the date input and also the date picker using the `NgxDatePickerInputConfig` interface. For example,\nyou can use the following code to enable `dark-mode`:\n\n```typescript\ndatePickerConfig: NgxDatePickerInputConfig = Object.assign(getInputConfigDefaults(), {\n  darkMode: false\n});\n```\n\nYou then just need to pass that config to the `ngx-date-picker-input` using the `[config]=\"datePickerConfig\"` attribute.\n\n**Full options are listed below:**\n\n```typescript\n{\n  minDate: Date;\n  maxDate: Date;\n  initialView: ViewMode;\n  rangeMode: boolean;\n  darkMode: boolean;\n  datePresentationFormat: string;\n  datePresentationLocale: string;\n  datePresentationValue: any;\n}\n```\n\n## Using the Picker Directory\n\nIf you do not wish to use the input component, you can instead use the picker directly.\n\n### How To Use\n\n```html\n\u003cngx-date-picker [(date)]=\"dateSelection\" (dateChange)=\"onDateChanges()\"\u003e\u003c/ngx-date-picker\u003e\n\u003cdiv\u003e{{dateSelection | json}}\u003c/div\u003e\n```\n\n**In your component:**\n\n```typescript\n@Component({\n  templateUrl: './example.component.html',\n  styleUrls: ['./example.component.scss']\n})\nexport class ExampleComponent {\n    dateSelection: DateSelection | undefined\n\n  onDateChanges() {\n    console.log(this.dateSelection);\n  }\n}\n```\n\n## Styling\n\nIf you would like to override styling, you can use the following (as an example):\n\n**Change the date selector day color:**\n\n```css\n::ng-deep ngx-date-picker {\n  --ngx-date-picker-highlight-background-color: red !important;\n}\n```\n\n**Change the date picker input width and background color:**\n\n```css\n::ng-deep ngx-date-picker-input {\n  width: 450px;\n}\n\n::ng-deep ngx-date-picker-input input {\n  background-color: #efefef;\n}\n```\n\n## Contributing\n\nFeel free to fire off a PR if you have any improvements.\n\n## Support\n\nPlease contact me if you need any help.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscottstraughan%2Fngx-simple-date-picker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fscottstraughan%2Fngx-simple-date-picker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscottstraughan%2Fngx-simple-date-picker/lists"}