React Date Time Input (日時入力) の概要

Ignite UI for React Date Time Input を使用すると、ユーザーは選択した入力要素で日付と時刻を設定および編集できます。ユーザーは、編集可能なマスクされた入力を使用して、日付と時刻の両方のパーツを編集できます。さらに、検証に最小値と最大値だけでなく、希望の表示形式および入力形式の設定を指定できます。

EXAMPLE

TSX

import React from 'react';
import ReactDOM from 'react-dom/client';
import './index.css';
import { IgrIcon, IgrIconModule, IgrDateTimeInput, IgrDateTimeInputModule, DatePart } from "@infragistics/igniteui-react";
import 'igniteui-webcomponents/themes/light/bootstrap.css';

IgrIconModule.register();
IgrDateTimeInputModule.register();

export default class DateTimeInputOverview extends React.Component<any, any> {

    private dateTimeInput: IgrDateTimeInput;
    constructor(props: any) {
        super(props);           
        this.iconRef = this.iconRef.bind(this);     
        this.dateTimeInputRef = this.dateTimeInputRef.bind(this);
    }

    public render(): JSX.Element {
        return (
            <div className="container sample">
                <IgrDateTimeInput ref={this.dateTimeInputRef}>
                    <span slot="prefix" key="prefix" onClick={() => this.dateTimeInput.clear()}>
                    <IgrIcon ref={this.iconRef} name="clear" collection="material" />
                    </span>
                    <span slot="suffix" key="upSuffix" onClick={() => this.dateTimeInput.stepUp(DatePart.Month)}>
                    <IgrIcon ref={this.iconRef} name="up" collection="material" />
                    </span>
                    <span slot='suffix' key="downSuffix" onClick={() => this.dateTimeInput.stepDown(DatePart.Month)}>
                    <IgrIcon ref={this.iconRef} name="down" collection="material" />
                    </span> 
                </IgrDateTimeInput>
            </div>
        );
    }

    public dateTimeInputRef(input: IgrDateTimeInput) {
        if (!input) { return; }
        this.dateTimeInput = input;
    }

    public iconRef(icon: IgrIcon){
        if (!icon) { return; }
        const upIconText = '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M7 14l5-5 5 5z"/></svg>';
        const downIconText = '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M7 10l5 5 5-5z"/></svg>';
        const clearIconText = '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>';
        icon.registerIconFromText("up", upIconText, "material");
        icon.registerIconFromText("down", downIconText, "material");
        icon.registerIconFromText("clear", clearIconText, "material");
    }

}

// rendering above class to the React DOM
const root = ReactDOM.createRoot(document.getElementById('root'));
root.render(<DateTimeInputOverview/>);
tsxコピー

Edit in: Codesandbox

このサンプルが気に入りましたか? 完全な Ignite UI for Reactツールキットにアクセスして、すばやく独自のアプリの作成を開始します。無料でダウンロードできます。

使用方法

まず、次のコマンドを実行して、対応する Ignite UI for React npm パッケージをインストールする必要があります:

npm install igniteui-react
cmd

次に、以下のように、IgrDateTimeInput とそれに必要な CSS をインポートし、そのモジュールを登録する必要があります:

import { IgrDateTimeInput, IgrDateTimeInputModule } from 'igniteui-react';
import 'igniteui-webcomponents/themes/light/bootstrap.css';
IgrDateTimeInputModule.register();
tsx

値バインディング

IgrDateTimeInput コンポーネントの値を設定する最も簡単な方法は、Date オブジェクトを value プロパティに渡すことです。

public dateTimeInputRef(input: IgrDateTimeInput) {
    if (!input) { return; }
    input.value = new Date();
}
tsx

IgrDateTimeInput は、ISO 8601 文字列も受け入れます。

文字列は、YYYY-MM-DDTHH:mm:ss.sssZ の形式の完全な ISO 文字列にすることも、日付のみと時間のみのパーツに分割することもできます。

日付のみ

日付のみの文字列がコンポーネントの value プロパティにバインドされている場合は、YYYY-MM-DD の形式である必要があります。inputFormat は、入力に値を入力するときに引き続き使用され、同じ形式である必要はありません。さらに、日付のみの文字列をバインドする場合、ディレクティブは時刻を T00:00:00 に強制することにより、時刻のずれを防ぎます。

時刻のみ

時刻のみの文字列は通常、ECMA 仕様では定義されていませんが、時刻のみのソリューションを必要とするシナリオにディレクティブを統合できるようにするために、24 時間形式 (HH:mm:ss) をサポートしています。12 時間形式はサポートされていません。

完全な ISO 文字列

完全な ISO 文字列がバインドされている場合、ディレクティブは、Date.parse に必要なすべての要素が提供されている場合にのみそれを解析します。

InvalidDate を含むすべての falsy の値は、null として解析されます。不完全な日付のみ、時間のみ、または完全な ISO 文字列は、InvalidDate として解析されます。

キーボード ナビゲーション

IgrDateTimeInput には直感的なキーボード ナビゲーションがあり、マウスに触れることなく、さまざまな DatePart を簡単に増分、減分、またはジャンプできます。

キー	説明
←	1 文字を先頭に移動
→	1 文字を最後に移動
Home	最初に移動
End	最後に移動
Ctrl / Command + ←	日付 / 時刻セクションの先頭に移動 - 現在のセクションまたは左側のセクション
Ctrl / Command + →	日付 / 時刻セクションの最後に移動 - 現在または右側のセクション
日付 / 時刻のパーツにフォーカス + ↓	日付 / 時刻のパーツを減分
日付 / 時刻のパーツにフォーカス + ↑	日付 / 時刻のパーツを増分
Ctrl / Command + ;	現在の日付 / 時刻をエディターの値として設定

書式の設定

IgrDateTimeInput は、さまざまな表示形式と入力形式をサポートしています。

Intl.DateTimeFormat を使用して、long と short、medium と full などの事前定義された書式オプションをサポートできるようにします。さらに、dd-MM-yy などのサポートされている文字から構築されたカスタム文字列を受け入れることもできます。また、displayFormat が指定されていない場合、コンポーネントは inputFormat をそのまま使用します。

入力書式

次の表は、コンポーネントの inputFormat でサポートされている形式を示しています。

書式	説明
d	日付。編集中は先行ゼロで強制されます。
dd	先行ゼロが明示的に設定された日付。
M	月。編集中は先行ゼロで強制されます。
MM	先行ゼロが明示的に設定されている月。
yy	短い年形式。
yyyy	完全な年形式。
h	12 時間形式の時間。編集中は先行ゼロで強制されます。
hh	明示的に先行ゼロが設定された 12 時間形式の時間。
H	24 時間形式の時間。編集中は先行ゼロで強制されます。
HH	明示的に先行ゼロが設定された 24 時間形式の時間。
m	分。編集中に先行ゼロで強制されます。
mm	先行ゼロが明示的に設定された分。
tt	12 時間形式の AM/PM セクション。

特定の入力形式を設定するには、それを文字列として IgrDateTimeInput に渡します。これにより、予想されるユーザー入力形式と mask の両方が設定されます。さらに、inputFormat はロケール ベースであるため、何も指定されていない場合、エディターはデフォルトで dd/MM/yyyy になります。

<IgrDateTimeInput ref={this.dateTimeInputRef} inputFormat="dd-MM-yy" displayFormat="medium"></IgrDateTimeInput>
tsx

以下は結果です:

EXAMPLE

TSX

import React from 'react';
import ReactDOM from 'react-dom/client';
import './index.css';
import { IgrIcon, IgrIconModule, IgrDateTimeInput, IgrDateTimeInputModule, DatePart } from "@infragistics/igniteui-react";
import 'igniteui-webcomponents/themes/light/bootstrap.css';

IgrIconModule.register();
IgrDateTimeInputModule.register();

export default class DateTimeInputInputFormatDisplayFormat extends React.Component<any, any> {

    private dateTimeInput: IgrDateTimeInput;
    constructor(props: any) {
        super(props);           
        this.iconRef = this.iconRef.bind(this);     
        this.dateTimeInputRef = this.dateTimeInputRef.bind(this);
    }

    public render(): JSX.Element {
        return (
            <div className="container sample">
                <IgrDateTimeInput ref={this.dateTimeInputRef} inputFormat="dd-MM-yy" displayFormat="medium">
                    <span slot="prefix" key="prefix" onClick={() => this.dateTimeInput.clear()}>
                    <IgrIcon ref={this.iconRef} name="clear" collection="material" />
                    </span>
                    <span slot="suffix" key="upSuffix" onClick={() => this.dateTimeInput.stepUp(DatePart.Date)}>
                    <IgrIcon ref={this.iconRef} name="up" collection="material" />
                    </span>
                    <span slot='suffix' key="downSuffix" onClick={() => this.dateTimeInput.stepDown(DatePart.Date)}>
                    <IgrIcon ref={this.iconRef} name="down" collection="material" />
                    </span> 
                </IgrDateTimeInput>
            </div>
        );
    }

    public dateTimeInputRef(input: IgrDateTimeInput) {
        if (!input) { return; }
        this.dateTimeInput = input;
    }

    public iconRef(icon: IgrIcon){
        if (!icon) { return; }
        const upIconText = '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M7 14l5-5 5 5z"/></svg>';
        const downIconText = '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M7 10l5 5 5-5z"/></svg>';
        const clearIconText = '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>';
        icon.registerIconFromText("up", upIconText, "material");
        icon.registerIconFromText("down", downIconText, "material");
        icon.registerIconFromText("clear", clearIconText, "material");
    }

}

// rendering above class to the React DOM
const root = ReactDOM.createRoot(document.getElementById('root'));
root.render(<DateTimeInputInputFormatDisplayFormat/>);
tsxコピー

Edit in: Codesandbox

表示書式

日時入力は、さまざまな方法で日付 / 時刻を表示するための事前定義された形式を公開します。以下の例はすべて、en-US ロケールで示されています。

オプション	例
short	7/17/22, 12:00 AM
medium	Jul 17, 2022, 12:00:00 AM
long	July 17, 2022 at 12:00:00 AM GMT+3
full	Sunday, July 17, 2022 at 12:00:00 AM Eastern European Summer Time
shortDate	7/17/22
mediumDate	Jul 17, 2022
longDate	July 17, 2022
fullDate	Sunday, July 17, 2022
shortTime	12:00 AM
mediumTime	12:00:00 AM
longTime	12:00:00 AM GMT+3
fullTime	12:00:00 AM Eastern European Summer Time

さらに、ユーザーは、次の表で説明されているサポートされている記号を使用して、displayFormat 文字列を作成できます。

タイプ	書式	説明	例
日付	d	最小桁数	7, 17
	dd	ゼロ埋込み	07, 17
月	M	最小桁数	3, 10
	MM	ゼロ埋込み	03, 10
	MMM	省略	Oct
	MMMM	ワイド	October
	MMMMM	狭い	O
年	y	数値	2022
	yy	2 桁	22
	yyy	数値	2022
	yyyy	数値	2022
12 時間	h	最小桁数	1, 12
	hh	ゼロ埋込み	01, 12
24 時間	H	最小桁数	1, 23
	HH	ゼロ埋込み	01, 23
分	m	最小桁数	1, 59
	mm	ゼロ埋込み	01, 59
秒	s	最小桁数	1, 59
	ss	ゼロ埋込み	01, 59
期間	t	省略	AM, PM
	tt	省略	AM, PM
	ttt	短い	noon
	tttt	長い	noon
	ttttt	狭い	n

多くのロケールは、指定された書式に関係なく、同じ期間文字列を使用します。また、12 時間制を使用した場合にのみ効果があります。

最小値 / 最大値

min および max プロパティを指定して、コンポーネントの入力を制限し、有効性を制御できます。value プロパティと同様に、string 型にすることができます。

public dateTimeInputRef(input: IgrDateTimeInput) {
    if (!input) { return; }
    input.min = new Date(2021, 0, 1);
}
tsx

 <IgrDateTimeInput ref={this.dateTimeInputRef} max={new Date(2024, 6, 25)}></IgrDateTimeInput>
tsx

すべてがうまくいった場合、値が指定された日付よりも大きいか小さい場合、コンポーネントは invalid になります。以下の例をご覧ください:

EXAMPLE

TSX

import React from 'react';
import ReactDOM from 'react-dom/client';
import './index.css';
import { IgrIcon, IgrIconModule, IgrDateTimeInput, IgrDateTimeInputModule, DatePart } from "@infragistics/igniteui-react";
import 'igniteui-webcomponents/themes/light/bootstrap.css';

IgrIconModule.register();
IgrDateTimeInputModule.register();

export default class DateTimeInputMinMaxValue extends React.Component<any, any> {

    private dateTimeInput: IgrDateTimeInput;
    constructor(props: any) {
        super(props);           
        this.iconRef = this.iconRef.bind(this);     
        this.dateTimeInputRef = this.dateTimeInputRef.bind(this);
    }

    public render(): JSX.Element {
        return (
            <div className="container sample">
                <IgrDateTimeInput ref={this.dateTimeInputRef} max={new Date(2024, 6, 25)}>
                    <span slot="prefix" key="prefix" onClick={() => this.dateTimeInput.clear()}>
                    <IgrIcon ref={this.iconRef} name="clear" collection="material" />
                    </span>
                    <span slot="suffix" key="upSuffix" onClick={() => this.dateTimeInput.stepUp(DatePart.Month)}>
                    <IgrIcon ref={this.iconRef} name="up" collection="material" />
                    </span>
                    <span slot='suffix' key="downSuffix" onClick={() => this.dateTimeInput.stepDown(DatePart.Month)}>
                    <IgrIcon ref={this.iconRef} name="down" collection="material" />
                    </span> 
                </IgrDateTimeInput>
            </div>
        );
    }

    public dateTimeInputRef(input: IgrDateTimeInput) {
        if (!input) { return; }
        input.min = new Date(2021, 0, 1);
        this.dateTimeInput = input;
    }

    public iconRef(icon: IgrIcon){
        if (!icon) { return; }
        const upIconText = '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M7 14l5-5 5 5z"/></svg>';
        const downIconText = '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M7 10l5 5 5-5z"/></svg>';
        const clearIconText = '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>';
        icon.registerIconFromText("up", upIconText, "material");
        icon.registerIconFromText("down", downIconText, "material");
        icon.registerIconFromText("clear", clearIconText, "material");
    }

}

// rendering above class to the React DOM
const root = ReactDOM.createRoot(document.getElementById('root'));
root.render(<DateTimeInputMinMaxValue/>);
tsxコピー

Edit in: Codesandbox

ステップアップ / ステップダウン

IgrDateTimeInput は、公開な stepUp メソッドと stepDown メソッドを公開します。現在設定されている日付と時刻の特定の DatePart を増減し、いくつかの方法で使用できます。

最初のシナリオでは、特定の DatePart がメソッドに渡されない場合、指定した inputFormat および内部コンポーネントの実装に基づいてデフォルトの DatePart が増減します。2 番目のシナリオでは、さまざまな要件を満たすために操作する DatePart を明示的に指定できます。また、どちらのメソッドも、stepUp/stepDown ステップを設定するために使用できるタイプ番号のオプションの delta パラメーターを受け入れます。

以下の例をご覧ください。

EXAMPLE

TSX

import React from 'react';
import ReactDOM from 'react-dom/client';
import './index.css';
import { IgrIcon, IgrIconModule, IgrDateTimeInput, IgrDateTimeInputModule, DatePart } from "@infragistics/igniteui-react";
import 'igniteui-webcomponents/themes/light/bootstrap.css';

IgrIconModule.register();
IgrDateTimeInputModule.register();

export default class DateTimeInputStepUpDown extends React.Component<any, any> {

    private dateTimeInput: IgrDateTimeInput;
      
    constructor(props: any) {
        super(props);
        this.iconRef = this.iconRef.bind(this);     
        this.dateTimeInputRef = this.dateTimeInputRef.bind(this);
    }

    public render(): JSX.Element {
        return (
            <div className="container sample">
                <IgrDateTimeInput ref={this.dateTimeInputRef}>
                    <span slot="prefix" key="prefix" onClick={() => this.dateTimeInput.clear()}>
                    <IgrIcon ref={this.iconRef} name="clear" collection="material" />
                    </span>
                    <span slot="suffix" key="upSuffix" onClick={() => this.dateTimeInput.stepUp(DatePart.Month, 3)}>
                    <IgrIcon ref={this.iconRef} name="up" collection="material" />
                    </span>
                    <span slot='suffix' key="downSuffix" onClick={() => this.dateTimeInput.stepDown(DatePart.Date, 2)}>
                    <IgrIcon ref={this.iconRef} name="down" collection="material" />
                    </span> 
                </IgrDateTimeInput>
            </div>
        );
    }

    public dateTimeInputRef(input: IgrDateTimeInput) {
        if (!input) { return; }
        this.dateTimeInput = input;
    }

    public iconRef(icon: IgrIcon){
        if (!icon) { return; }
        const upIconText = '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M7 14l5-5 5 5z"/></svg>';
        const downIconText = '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M7 10l5 5 5-5z"/></svg>';
        const clearIconText = '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>';
        icon.registerIconFromText("up", upIconText, "material");
        icon.registerIconFromText("down", downIconText, "material");
        icon.registerIconFromText("clear", clearIconText, "material");
    }

}

// rendering above class to the React DOM
const root = ReactDOM.createRoot(document.getElementById('root'));
root.render(<DateTimeInputStepUpDown/>);
tsxコピー

Edit in: Codesandbox

スタイル設定

IgrDateTimeInput コンポーネントは、その内部要素のほとんどすべての CSS パーツを公開します。次の表に、公開されているすべての CSS パーツを示します。

名前	説明
container	すべての主要な入力要素を保持するメイン ラッパー。
input	ネイティブ入力要素。
label	ネイティブ ラベル要素。
prefix	プレフィックス ラッパー。
suffix	サフィックス ラッパー。
helper-text	ヘルパー テキスト ラッパー。

igc-date-time-input::part(input) {
  background-color: var(--ig-primary-100);
  border-color: var(--ig-secondary-500);
  box-shadow: none;
}

igc-date-time-input::part(prefix),
igc-date-time-input::part(suffix) {
  color: var(--ig-primary-600-contrast);
  background-color: var(--ig-primary-500);
  border-color: var(--ig-secondary-500);
}
css

EXAMPLE

Edit in: Codesandbox

API リファレンス

• IgrInput
• IgrMaskInput
• IgrIcon
• IgrDateTimeInput
• スタイル設定 & テーマ

その他のリソース

• Ignite UI for React フォーラム (英語)
• Ignite UI for React GitHub (英語)