chartjs-adapter-luxon
Overview
This adapter allows the use of Luxon with Chart.js. Luxon provides built-in support for time zones and internationalization.
Requires Chart.js 2.8.0 or later and Luxon 1.0.0 or later.
Note: once loaded, this adapter overrides the default date-adapter provided in Chart.js (as a side-effect).
Installation
npm
npm install luxon chartjs-adapter-luxon --save
import Chart from 'chart.js';
import 'chartjs-adapter-luxon';
CDN
By default, https://cdn.jsdelivr.net/npm/chartjs-adapter-luxon
returns the latest (minified) version, however it's highly recommended to always specify a version in order to avoid breaking changes. This can be achieved by appending @{version}
to the URL:
<script src="https://cdn.jsdelivr.net/npm/chart.js@2.8.0"></script>
<script src="https://cdn.jsdelivr.net/npm/luxon@1.15.0"></script>
<script src="https://cdn.jsdelivr.net/npm/chartjs-adapter-luxon@0.2.0"></script>
Read more about jsDelivr versioning on their website.
Configuration
Any date adapter options in the chart configuration will be passed through to Luxon's factory functions. See the Luxon API docs for the supported options, such as zone
and locale
, that these functions accept.
Read the Chart.js documention for other possible date/time related options. For example, the time scale time.*
options can be overridden using the Luxon formats.
Development
You first need to install node dependencies (requires Node.js):
> npm install
The following commands will then be available from the repository root:
> gulp build // build dist files
> gulp build --watch // build and watch for changes
> gulp lint // perform code linting
License
chartjs-adapter-luxon
is available under the MIT license.