forked from arqex/react-datetime
-
Notifications
You must be signed in to change notification settings - Fork 0
/
DateTime.d.ts
192 lines (182 loc) · 8.24 KB
/
DateTime.d.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
// Type definitions for react-datetime
// Project: https://github.com/YouCanBookMe/react-datetime
// Definitions by: Ivan Verevkin <vereva@x-root.org>
// Updates by: Aaron Spaulding <aaron@sachimp.com>,
// Karol Janyst <http://github.com/LKay>
import { Component, ChangeEvent, FocusEvent, FocusEventHandler } from "react";
import { Moment } from "moment";
export = ReactDatetimeClass;
declare namespace ReactDatetimeClass {
/*
The view mode can be any of the following strings.
*/
export type ViewMode = "years" | "months" | "days" | "time";
export interface TimeConstraint {
min: number;
max: number;
step: number;
}
export interface TimeConstraints {
hours?: TimeConstraint;
minutes?: TimeConstraint;
seconds?: TimeConstraint;
milliseconds?: TimeConstraint;
}
type EventOrValueHandler<Event> = (event: Event | Moment | string) => void;
export interface DatetimepickerProps {
/*
Represents the selected date by the component, in order to use it as a controlled component.
This prop is parsed by moment.js, so it is possible to use a date string or a moment.js date.
*/
value?: Date | string | Moment;
/*
Represents the selected date for the component to use it as a uncontrolled component.
This prop is parsed by moment.js, so it is possible to use a date string or a moment.js date.
*/
defaultValue?: Date | string | Moment;
/*
Represents the month which is viewed on opening the calendar when there is no selected date.
This prop is parsed by Moment.js, so it is possible to use a date `string` or a `moment` object.
*/
viewDate?: Date | string | Moment;
/*
Defines the format for the date. It accepts any moment.js date format.
If true the date will be displayed using the defaults for the current locale.
If false the datepicker is disabled and the component can be used as timepicker.
*/
dateFormat?: boolean | string;
/*
Defines the format for the time. It accepts any moment.js time format.
If true the time will be displayed using the defaults for the current locale.
If false the timepicker is disabled and the component can be used as datepicker.
*/
timeFormat?: boolean | string;
/*
Whether to show an input field to edit the date manually.
*/
input?: boolean;
/*
Whether to open or close the picker. If not set react-datetime will open the
datepicker on input focus and close it on click outside.
*/
open?: boolean;
/*
Manually set the locale for the react-datetime instance.
Moment.js locale needs to be loaded to be used, see i18n docs.
*/
locale?: string;
/*
Whether to interpret input times as UTC or the user's local timezone.
*/
utc?: boolean;
/*
When specified, input time values will be displayed in the given time zone. Otherwise they will default
to the user's local timezone (unless `utc` specified).
*/
displayTimeZone?: string;
/*
Callback trigger when the date changes. The callback receives the selected `moment` object as
only parameter, if the date in the input is valid. If the date in the input is not valid, the
callback receives the value of the input (a string).
*/
onChange?: (value: Moment | string) => void;
/*
Callback trigger for when the user opens the datepicker.
*/
onFocus?: FocusEventHandler<any>;
/*
Callback trigger for when the user clicks outside of the input, simulating a regular onBlur.
The callback receives the selected `moment` object as only parameter, if the date in the input
is valid. If the date in the input is not valid, the callback receives the value of the
input (a string).
*/
onBlur?: EventOrValueHandler<FocusEvent<any>>;
/*
Callback trigger when the view mode changes. The callback receives the selected view mode
string ('years', 'months', 'days', 'time') as only parameter.
*/
onViewModeChange?: (viewMode: string) => void;
/*
Callback trigger when the user navigates to the previous month, year or decade.
The callback receives the amount and type ('month', 'year') as parameters.
*/
onNavigateBack?: (amount: number, type: string) => void;
/*
Callback trigger when the user navigates to the next month, year or decade.
The callback receives the amount and type ('month', 'year') as parameters.
*/
onNavigateForward?: (amount: number, type: string) => void;
/*
The default view to display when the picker is shown. ('years', 'months', 'days', 'time')
*/
viewMode?: ViewMode | number;
/*
Extra class names for the component markup.
*/
className?: string;
/*
Defines additional attributes for the input element of the component.
*/
inputProps?: React.HTMLProps<HTMLInputElement>;
/*
Define the dates that can be selected. The function receives (currentDate, selectedDate)
and should return a true or false whether the currentDate is valid or not. See selectable dates.
*/
isValidDate?: (currentDate: any, selectedDate: any) => boolean;
/*
Customize the way that the days are shown in the day picker. The accepted function has
the selectedDate, the current date and the default calculated props for the cell,
and must return a React component. See appearance customization
*/
renderDay?: (props: any, currentDate: any, selectedDate: any) => JSX.Element;
/*
Customize the way that the months are shown in the month picker.
The accepted function has the selectedDate, the current date and the default calculated
props for the cell, the month and the year to be shown, and must return a
React component. See appearance customization
*/
renderMonth?: (props: any, month: number, year: number, selectedDate: any) => JSX.Element;
/*
Customize the way that the years are shown in the year picker.
The accepted function has the selectedDate, the current date and the default calculated
props for the cell, the year to be shown, and must return a React component.
See appearance customization
*/
renderYear?: (props: any, year: number, selectedDate: any) => JSX.Element;
/*
Whether to use moment's strict parsing when parsing input.
*/
strictParsing?: boolean;
/*
When true, once the day has been selected, the react-datetime will be automatically closed.
*/
closeOnSelect?: boolean;
/*
Allow to add some constraints to the time selector. It accepts an object with the format
{hours:{ min: 9, max: 15, step:2}} so the hours can't be lower than 9 or higher than 15, and
it will change adding or subtracting 2 hours everytime the buttons are clicked. The constraints
can be added to the hours, minutes, seconds and milliseconds.
*/
timeConstraints?: TimeConstraints;
/*
When true, keep the picker open when click event is triggered outside of component. When false,
close it.
*/
disableOnClickOutside?: boolean;
/*
When true, keep the picker in a seperate node on the Document's body so that it is not obscured
behind an `overflow: hidden` or `z-index` issue. When false, render the date picker modal next
to the input element.
*/
usePortal?: boolean;
}
export interface DatetimepickerState {
updateOn: string;
inputFormat: string;
viewDate: Moment;
selectedDate: Moment;
inputValue: string;
open: boolean;
}
}
declare class ReactDatetimeClass extends Component<ReactDatetimeClass.DatetimepickerProps, ReactDatetimeClass.DatetimepickerState> {}