日期時間 獨立
日期時間是 DataTables 自己的日期時間選擇器,我們主要在 Editor 和 搜尋建立器 擴充套件中使用,以提供使用者友善的方式來選擇日期和時間的值。如果您希望在其他用途中使用,或作為 DataTables 的自訂擴充套件的一部分,則可以根據 MIT 許可免費使用。
除了標準的 JS 日期格式外,日期時間還提供與 Moment、Luxon 和 Dayjs 的完整整合。
安裝
有多種不同的方式可以在您的網頁/專案中加入日期時間函式庫。
瀏覽器
取得和使用日期時間最簡單的方法是使用 DataTables 下載產生器,您可以在其中選擇您希望在網頁上使用的軟體,並為您建立並託管單個 Javascript 和 CSS 檔案。當同時使用搜尋建立器套件和編輯器時,您需要確保包含此檔案。
或者,您可以將個別檔案包含在您的網頁中、下載發佈套件,或在 GitHub 上複製原始碼控制儲存庫。
NPM
日期時間函式庫在 NPM 上以 datatables.net-datetime
提供。使用您的套件管理員(例如 NPM、Yarn 或類似工具)進行安裝
npm install --save datatables.net-datetime
ES 模組
要在 ES 模組專案中使用此函式庫,只需匯入它即可
import DateTime from 'datatables.net-datetime';
CommonJS
如果您的專案使用 CommonJS 載入器,則就像 DataTables 核心及其其他擴充套件一樣,日期時間會匯出一個函式,該函式可以選擇性地傳遞 window
和 jQuery
物件,否則它會自動解析它們
const DateTime = require('datatables.net-datetime')();
// or
const DateTime = require('datatables.net-datetime')(window, jQuery);
初始化
如果您在網頁上包含日期時間擴充套件,則該網頁上的每個 DataTable 和擴充套件都可以自動使用它。使用日期時間的擴充套件會自行初始化它,因此無需擔心。當然,也可以在 DataTables 外部初始化日期時間實例。若要執行此操作,只需建立日期時間的新實例,並傳遞目標 input
元素。
new DateTime(document.getElementById('myInput'));
也可以透過 jQuery 初始化日期時間
$('#myInput').dtDateTime();
設定配置選項的方式是傳遞第二個引數(如果使用 jQuery 樣式初始化,則為第一個引數),該引數是一個包含要設定的選項的物件。完整文件提供了這些選項的說明。
new DateTime(document.getElementById('test'), {
locale: 'fr'
});
還有各種可用的 API 方法。它們的文件在此,並且在下面包含其使用範例。
var dt = new DateTime(document.getElementById('example'));
dt.val("2021-12-31");
若要使用 Moment、Luxon 或 Dayjs,唯一需要的初始化是在網頁上包含它們。這樣做就可以使用 ISO8601 以外的格式。此處提供使用這些函式庫的範例,適用於 Moment、Luxon 和 Dayjs。
功能
日期時間新增了以下功能
- 輕鬆選擇日期和時間
- 完全可自訂的日期格式
- 完全可自訂的地區設定
- 完全國際化