19.1.0 • Published 7 months ago

@netwin/angular-datetime-picker v19.1.0

Weekly downloads
-
License
MIT
Repository
github
Last release
7 months ago

:date: :clock1: Angular Date/Time Picker

npm npm

How to Use

Install this library by running

npm install @netwin/angular-datetime-picker

Afterwards, add the global stylesheet to your styles section within your angular.json file:

"styles": [
    "node_modules/@netwin/angular-datetime-picker/assets/style/picker.min.css",
    "... other styles"
]

To then use it, import both the OwlDateTimeModule and OwlNativeDateTimeModule in your app.module.ts or in your component that wants to use it:

import { OwlDateTimeModule, OwlNativeDateTimeModule } from '@netwin/angular-datetime-picker';

@NgModule({
  imports: [OwlDateTimeModule, OwlNativeDateTimeModule],
  ...
})
export class AppModule {}

or

import { OwlDateTimeModule, OwlNativeDateTimeModule } from '@netwin/angular-datetime-picker';

@Component({
  standalone: true,
  selector: 'app-my-feature-with-datetime-picker',
  templateUrl: './app.component.html',
  styleUrl: './app.component.css',
  providers: [OwlDateTimeModule, OwlNativeDateTimeModule]
})
export class MyFeatureWithDatetimePickerComponent {}

Last but not least, simply use the picker in your HTML file like so:

<owl-date-time-inline [...]="..." />

See below for more information on the properties you can use.

Properties for owl-date-time-inline

NameTypeRequiredDefaultDescription
pickerTypeboth, calendar, timerOptionalbothSet the type of the dateTime picker. both: show both calendar and timer, calendar: only show calendar, timer: only show timer.
startViewmonth, year, multi-yearOptionalmonthThe view that the calendar should start in.
startAtT / nullOptionalnullThe moment to open the picker to initially.
endAtT / nullOptionalnullThe the default selected time for range calendar end time
firstDayOfWeeknumberOptional0Set the first day of week. Valid value is from 0 to 6. 0: Sunday - 6: Saturday
showSecondsTimerbooleanOptionalfalseWhen specify it to true, it would show a timer to configure the second's value
hideOtherMonthsbooleanOptionalfalseWhether to hide dates in other months at the start or end of the current month
hour12TimerbooleanOptionalfalseWhen specify it to true, the timer would be in hour12 format mode
stepHournumberOptional1Hours to change per step.
stepMinutenumberOptional1Minutes to change per step.
stepSecondnumberOptional1Seconds to change per step.
disabledbooleanOptionalfalseWhen specify to true, it would disable the picker.
owlDateTimeFilter( date: T)=>booleanOptionalnullA function to filter date time.
min<T>OptionalnullThe minimum valid date time.
max<T>OptionalnullThe maximum valid date time.
selectModesingle, range, rangeFrom, rangeToOptionalsingleSpecify the picker's select mode. single: a single value allowed, range: allow users to select a range of date-time, rangeFrom: the input would only show the 'from' value and the picker could only selects 'from' value, rangeTo: the input would only show the 'to' value and the picker could only selects 'to' value.

!NOTE There are more expored / usable components in the previous implementation. In order to improve simplicity and reusability, these components (while still in the bundle as of version 18.x) are not recommended to be used anymore.

Localization and DateTime Format

Localization for different languages and formats is defined by OWL_DATE_TIME_LOCALE and OWL_DATE_TIME_FORMATS. You could learn more about this from here.

License

  • License: MIT

Author

Maintained by NetWin, based on the awesome work from Daniel Moncada and Daniel Pan. The original repo is still active, go check it out here.

19.1.0

7 months ago

19.0.0

1 year ago

18.4.0

1 year ago

18.3.0

1 year ago

19.0.0-rc.5

1 year ago

19.0.0-rc.6

1 year ago

19.0.0-rc.2

1 year ago

19.0.0-rc.3

1 year ago

19.0.0-rc.4

1 year ago

19.0.0-rc.1

1 year ago

1.0.0-rc.3

1 year ago

18.1.0-rc.1

1 year ago

18.2.0

1 year ago

18.1.0-rc.2

1 year ago

18.1.0

1 year ago

18.0.0

2 years ago