1.0.25 • Published 1 year ago

@1stquad/react-bootstrap-datetimepicker v1.0.25

Weekly downloads
126
License
MIT
Repository
github
Last release
1 year ago

react-bootstrap-datetimepicker

This project is a port of https://github.com/Eonasdan/bootstrap-datetimepicker for React.js

Usage

Installation : npm install --save @1stquad/react-bootstrap-datetimepicker

Then

//ES5
var DateTimeField = require('react-bootstrap-datetimepicker');

//ES6
import DateTimeField from "react-bootstrap-datetimepicker"

...

render: function() {
  return <DateTimeField />;
}

See Examples for more details.

API

DateTimeField

NameTypeDefaultDescription
dateTimestring or momentmoment.utc().format('x')Represents the initial dateTime. If this is a string it will be parsed by moment.js using format, otherwise an existing moment instance may be used.
formatstring"x"Defines the format moment.js should use to parse and output the date to onChange
inputFormatstring or arraysee default format table belowDefines the accepted date formats in the HTML input. It must be a format understandable by moment.js
inputDisplayFormatstringWhen there is no inputFormat given: see default format table below. When an inputFormat is given and it is a string: it takes the inputFormat. When the inputFormat is an array: it takes the first inputFormat.Defines the display format of the date in the HTML input. It must be a format understandable by moment.js. If there is an inputFormat given, the inputDisplayFormat must be one of the formats listed in the inputFormat
onChangefunctionx => console.log(x)Callback trigger when the date changes. x is the new datetime value.
onBlurfunction() => {}Callback trigger when the date field blurs.
onEnterKeyDownfunction() => {}Callback trigger when the Enter key is pressed.
showTodaybooleantrueHighlights today's date
sizestring"md"Changes the size of the date picker input field. Sizes: "sm", "md", "lg"
daysOfWeekDisabledarray of integer[]Disables clicking on some days. Goes from 0 (Sunday) to 6 (Saturday).
viewModestring or number'days'The default view to display when the picker is shown. ('time', 'years', 'months', 'days')
inputPropsobjectundefinedDefines additional attributes for the input element of the component.
inputRefstring or functioninputDateTimeAllows a custom reference to be passed to the input field.
minDatemomentundefinedThe earliest date allowed for entry in the calendar view.
maxDatemomentundefinedThe latest date allowed for entry in the calendar view.
modestringundefinedAllows to selectively display only the time picker ('time'), date picker ('date'), date-timepicker ('datetime') or month picker ('month')
defaultTextstringundefinedSets the input's placeholder value. Could be an empty string, or helper text.
namestringundefinedSets the name of the input element.
tabIndexstringundefinedSets the tabIndex of the input element.
startOfWeekstring"isoWeek"Define start of week day. ('isoWeek' - from Monday, 'week' - from Sunday)

Default Format Based on Mode

ModeFormat
time"h:mm A"
date"MM/DD/YY"
month"MM/YY"
none given"MM/DD/YY h:mm A"

Release Process

Once your pull request has been merged to master:

  1. Make sure you have the latest changes by running git pull on the master branch.
  2. (Optional) Check that your changes are reflected in the lib/react-bootstrap-datetimepicker.js file by running npm run build-npm and checking the file manually from the lib folder.
  3. When you're happy with your changes, run on your console:

    npm run patch-release #OR npm run minor-release #OR npm run major-release

Please respect semantic versioning!

If the release command fails, then please read what the release command does (see package.json), and figure out which step of the process went wrong, so that you can re-try just that bit. If you get stuck, ping #ex-myob-widgets for help!

Local linking to another project

  1. Run npm run build-npm from the react-bootstrap-datetimepicker console.
  2. In your other project's package.json, Use "@1stquad/react-bootstrap-datetimepicker: "#{local_path}/react-bootstrap-datetimepicker" instead of "@1stquad/react-bootstrap-datetimepicker": "1.0.5" in the dependency list.
  3. Run npm install @1stquad/react-bootstrap-datetimepicker from the same folder level as the package.json.

Update Warning

Starting from 0.0.6, the 3 github repositories react-bootstrap-datetimepicker, react-bootstrap-datetimepicker-npm and react-bootstrap-datetimepicker-bower are merged in a single one. The build process changed but the API is the same. However now the package exports DateTimeField directly, no need to do :

var DateTimeField = require('react-bootstrap-datetimepicker').DateTimeField;

instead use :

var DateTimeField = require('react-bootstrap-datetimepicker');

Contributions

There is still plenty of features missing compared to the original date time picker, hence contributions would be highly appreciated.

1.0.25

1 year ago

1.0.24

1 year ago

1.0.23

2 years ago

1.0.22

5 years ago

1.0.21

5 years ago

1.0.20

5 years ago

1.0.19

5 years ago

1.0.18

5 years ago

1.0.17

5 years ago

1.0.16

5 years ago

1.0.14

5 years ago

1.0.13

5 years ago

1.0.11

5 years ago

1.0.10

6 years ago

1.0.9

6 years ago

1.0.8

6 years ago

1.0.7

6 years ago

1.0.6

6 years ago

1.0.5

6 years ago

1.0.4

6 years ago

1.0.3

6 years ago

1.0.2

6 years ago

1.0.0

6 years ago