input type=time:15分刻み・秒入力・実際の値を確かめる
この記事では、時刻だけを入力するフォーム部品<input type="time">の基本と、日付やタイムゾーンを扱えない制限を説明します。
この記事でわかること
- 時刻の表示と実際の値の違い
- 15分刻み・秒入力と、min・maxの使い方
- 日付・タイムゾーンとサーバーでの確認
表示する日時と、入力する時刻を分ける
時刻を入力してもらうならinput type="time"を使います。日付や時刻を文章として示す場合は、time要素を使います。
| 指定 | 入力ルール |
|---|---|
step="60" | 1分刻み。stepを省略したときの既定値。 |
step="900" | 15分刻み。たとえば09:00、09:15、09:30。 |
step="1" | 1秒刻み。たとえば09:30:15。 |
入力欄が持つ値をvalueと呼びます。画面の表示と区別して確認します。時刻の値は24時間制です。分までなら09:30、秒を含むなら09:30:15のようになります。仕様は秒や秒の小数も扱います。入力画面の見た目と操作方法は、ブラウザやOSによって異なります。
<form>
<label for="alarm">時刻(09:00〜18:00)</label>
<input id="alarm" name="alarm" type="time"
min="09:00" max="18:00" step="900" required>
<button type="submit">確認する</button>
</form>
刻み幅と実際の値を確かめる
実際のvalue:09:30
09:30は、15分刻みに合っています。送信はしません。
09:30:15を入れたら、刻み幅を1秒に変えてみてください。秒を含む値と、刻み幅に合う値は別の条件だと分かります。このデモでは、送信する代わりに値を表示します。
時刻だけでは、世界のどの瞬間かは決まらない
09:30には日付もタイムゾーンもありません。国をまたぐ予約では、日付と「どの地域の09:30か」を別に決めてください。datetime-localもタイムゾーンは含みません。
ブラウザで合格した値でも、サーバーで営業時間・刻み幅などをもう一度確認します。分まで受け取るか、秒も受け取るかを、入力欄とサーバーでそろえてください。
根拠:HTML標準のtime入力。
A tag for creating a time selection input field.
<input type="time">
はじめに
HTML5で導入された<input type="time">は、ユーザーに時刻(例:14:30など)を簡単かつ正確に入力してもらうためのフォーム部品です。この要素を使うことで、従来のテキスト入力と比べて入力ミス(例:形式の間違いなど)を防ぎやすくなります。また、スマートフォンなどのモバイル端末では、画面上に専用の時刻ピッカーUI(スピナーやホイール型の選択UI)が自動的に表示され、指先で直感的に時刻を選べるようになります。一方、デスクトップ環境では、スピンボックス(数値の上下ボタン)やドロップダウン形式など、プラットフォームごとに最適化されたUIが提供されるため、JavaScriptを使って一からインターフェースを構築するよりも圧倒的に簡単に導入できます。
この入力欄が扱うのは、日付やタイムゾーンを含まない時刻です。秒も指定できますが、入力画面の見た目はブラウザやOSによって異なります。必要な精度をstepで指定し、実際の値を確認してください。
そのため、この要素を使用する際には、ブラウザごとの対応状況や仕様の制限を正しく理解したうえで、用途に応じた適切な使い方を心がけることが重要です。
最小構成 ―― “まず動かす”
HTML
<form>
<label for="alarm">アラーム時刻:</label>
<input id="alarm" type="time" name="alarm" required>
<button type="submit">送信</button>
</form>
フォームに含めることで、バリデーション(時刻が空なら送信ブロック)とキーボード操作が既に利用可能です。このデモでは送信後の画面遷移を止めています。ブラウザは自動で24時間または12時間表示を決めるため、ユーザー側はlocaleを意識せずに済みます。
主要属性と振る舞い
value
- 値は
HH:MMまたは秒を含むHH:MM:SSなどの形式(24時間制、月日やタイムゾーンは含まない) - 画面が12時間表示でも、送信する値は24時間制です
- 秒の指定はHTML標準で定義されています。1秒刻みにする場合は
step="1"を指定します。入力UIにはブラウザ・OSによる違いがあります
min / max
HTML
<input type="time" min="09:30" max="17:00">
- 入力値が範囲外だと
rangeUnderflow/rangeOverflowでネイティブエラー - 最小値・最大値にも有効な時刻の形式を使います。秒が必要なら
09:30:15のように指定できます
step
HTML
<input type="time" step="900"> <!-- 15 分刻み -->
- 単位は 秒。900 = 15 分
- デフォルトは 60 秒
- たとえば
09:00にstep="3600"を組み合わせると「毎時ちょうど」のみ許可
required, disabled, readonly, autofocus, autocomplete, list
- 通常の
<input>と同様 autocompleteは入力の目的に合う値を指定します。時刻だけの入力でも、利用者への説明に日付やタイムゾーンが必要な場合があります
注意 : placeholder はレンダリングされません。空欄時でもピッカー UI が前面に出るため、視覚的ヒントは <label> や外部テキストで補う必要があります。
JavaScript API
JavaScript
const el = document.querySelector('#alarm');
// 文字列として取得 / 設定
console.log(el.value); // "07:45" など
el.value = '08:00';
// 数値 (ミリ秒) で扱いたい場合
console.log(el.valueAsNumber); // 28800000(上で設定した08:00のミリ秒数)
el.valueAsNumber += 15 * 60 * 1000; // 15 分進める
// Date オブジェクト化(UTC 1970-01-01 基準)
const d = el.valueAsDate; // 15分進めた後なので1970-01-01T08:15:00.000Z
valueAsNumberは、その日の00:00からのミリ秒数です。空欄ではNaNになります。valueAsDateのUTC基準の値を、利用者のタイムゾーンが決まった日時と混同しないでください。
フォーム送信とサーバーサイド処理
次の例は、分または整数秒を受け取り、09:00〜18:00を許可します。秒の小数は受け取りません。15分刻みに限定する場合は、サーバーでも$seconds % 900(PHP)またはseconds % 900(JavaScript)が0か確認してください。
PHP
PHP
function secondsFromTime($value) {
if (!is_string($value) || !preg_match('/\A(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d)?\z/', $value)) {
return null;
}
$parts = array_map('intval', explode(':', $value));
return $parts[0] * 3600 + $parts[1] * 60 + ($parts[2] ?? 0);
}
$seconds = secondsFromTime($_POST['alarm'] ?? null);
if ($seconds === null || $seconds < 9 * 3600 || $seconds > 18 * 3600) {
http_response_code(400);
exit('09:00〜18:00の時刻を入力してください。');
}
Node.js (Express)
Expressのappを作り、express.urlencoded({ extended: false })でフォーム本文を読めるようにした後の例です。PHPの例と同じalarmという項目を受け取ります。
JavaScript
app.post('/reserve', (req, res) => {
const value = req.body?.alarm;
if (typeof value !== 'string' || value !== value.trim() ||
!/^(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d)?$/.test(value)) {
return res.status(400).send('Invalid time');
}
const [h, m, s = 0] = value.split(':').map(Number);
const seconds = h * 3600 + m * 60 + s;
if (seconds < 9 * 3600 || seconds > 18 * 3600) {
return res.status(400).send('Outside business hours');
}
return res.send('Time accepted');
});
重要ポイント : <input type="time"> 自体には タイムゾーン情報が含まれません。どの地域の時刻として受け取るかを、画面の説明とサーバーの処理でそろえます。ブラウザからタイムゾーンが自動で送られるわけではありません。
アクセシビリティ & UX
- ラベル
for属性で結びつける。スクリーンリーダーはラベルを読み上げ、操作モードを告知- エラーメッセージ
aria-invalid="true"とaria-describedbyでカスタムメッセージを紐付け- フォーカスリング
- ブラウザ既定の outline を尊重しつつ、CSS でコントラストを高める
- キーボード
ArrowUp/Downで分・時間を増減、Home/Endで最小/最大にジャンプ(ブラウザ依存あり)
スタイリングのコツ
CSS
/* アイコンを非表示にして独自 UI だけを見せる例 (Chrome / Edge) */
input[type="time"]::-webkit-calendar-picker-indicator {
opacity: 0;
pointer-events: none;
}
/* フォーカス時に時計アイコンをスライドインさせるイメージ */
input[type="time"]:focus-visible + .clock-icon {
transform: translateX(0); /* 初期は -100% で隠す */
}
Firefox は ::-moz-focus-inner/appearance で、Safari は現状カスタムしづらい点に注意。完全なクロスブラウザデザイン を目指すなら、隠さずネイティブ UI を活かす プログレッシブエンハンスメント戦略が推奨されます。
スマートフォン実装で押さえるポイント
デフォルト UI の違いを理解する
iOS は回転式ホイール、Android はダイヤル/キーパッド型など OS ごとにピッカー UI が異なります。これを前提に「完璧に同じ UI」を強要せず、OS ネイティブの操作感を尊重する方がアクセシビリティと保守性を高めます。
秒が必要な場合は、まずstep="1"を試します。独自の入力UIが必要な場合は、キーボード操作・フォーカス・読み上げ・入力の検証まで用意してください。標準の入力欄を隠すだけでは使いやすくなりません。
step・min・max 属性でタップ数を最小化
スマートフォンでも、入力に必要な操作が少なくなるように設計します。
15分刻みなら step="900" を指定します。これは有効な値の刻み幅です。ピッカーが15分ごとの候補だけを表示するとは限りません。
営業時間が決まっている場合は min="09:00" / max="18:00" を設定します。範囲外を選べるUIでも、値は無効と判定されます。候補の表示方法はブラウザによります。
24 h/12 h 表記の自動切替にまかせる
時刻表記は ブラウザのロケールと端末の時刻設定に従って自動で 24 h / 12 h が切り替わります。
アプリ側で強制したい場合はカスタムピッカーに切り替えるしかありませんが、ユーザーの慣れた表記を壊すリスクが高いので「表示はローカライズ任せ、内部の値は秒の有無に合う24時間制で扱う」設計が推奨されます。
バリデーションは「入力直後」+「送信前」の二段階
タッチ UI ではキーボードを閉じた瞬間に即時フィードバックを返さないと再入力が面倒になります。input イベントで簡易チェック → invalid / submit で確定チェックの二層に分け、エラーは フィールド直下に短文で表示。
フォーカス移動時にスクロール位置がずれやすいので、エラー要素へ scrollIntoView({block:"center"}) を添えると UX が安定します。
タッチ目標サイズとスペース確保
ガイドライン目安は 幅・高さともに 48 px(9 mm)以上、間隔 8 px 以上。
インラインで <input type="time"> を置く場合でも、ピッカー呼び出しアイコン・ラベル含めてタップ領域を確保し、意図しない隣接要素タップを避けます。
フォールバック戦略を持つ
今も一部の 旧 Android WebView/組み込みブラウザ は type="time" をサポートしません。非対応環境では type="text" として振る舞うため、プレースホルダーにフォーマット例(例: 09:30)を必ず入れるか、先頭で pattern="^([01]\d|2[0-3]):[0-5]\d$" を与えて手動入力を保護します。
さらに JavaScript でサポート検出を行い、未サポートなら軽量なポリフィル(inputmask・tiny-date-picker など)を動的読み込みすると UX が保たれます。
仮想キーボードのレイアウト崩れ対策
<input> が画面下部にある場合、キーボード出現でピッカーが隠れることがあります。
重要フォームでは scroll-padding-bottom に env(safe-area-inset-bottom)+80 px などを指定し、ピッカー or キーボード分だけ自動でスクロール余白を確保するとレイアウトジャンプを防げます。
ダークモード/高コントラストモード対応
モバイルは OS ダークモード比率が高いので、カスタムピッカーを実装する場合は prefers-color-scheme で配色を分岐。
システム UI をそのまま使う場合でも、隣接する入力枠・ラベルが背景と同化しないよう color-scheme: light dark; と background-color: Canvas 相当の変数を併用すると一貫性が高まります。
フォームの自動ズーム抑止
iOS Safari はフォントサイズ 16 px 未満の入力要素をタップすると自動ズームします。ズーム→ピッカー表示→戻る、の流れはユーザーが迷子になりやすいので、入力要素のフォントは必ず 16 px 以上に設定し、ズーム発生を防ぎましょう。
高速化とパフォーマンス
モバイルでは JavaScript 実行コストが直にバッテリーと熱に跳ね返ります。
カスタムピッカーの場合でも Shadow DOM+CSS Animation で極力 DOM 操作を減らし、スクロール同期や時刻リスト生成は requestAnimationFrame 内で行うとフレーム落ちが起きにくくなります。
フォント読み込み遅延があるとミリ秒単位で表示がブレるので、font-display: swap 指定で CLS を抑えてください。
これらを踏まえて実装すれば、OS 標準ピッカーの利点を活かしつつ、非対応環境や視認性・操作性の問題にも備えたモバイル向け<input type="time"> UI が完成します。
標準の入力欄を使えない場合の代替方法
機能検出:
JavaScript
const supportsTime = (() => {
const i = document.createElement('input');
i.setAttribute('type', 'time');
return i.type === 'time';
})();
代替のライブラリを使う場合は、キーボード・タッチ・読み上げの操作と、送信する値を確認します。
テキスト入力で代替する場合は、patternやinputmodeを検討します。type="time"自体にはpatternは適用されません。
秒が必要という理由だけで代替UIにする必要はありません。step="1"と実際の操作を先に確認します
よくある落とし穴
- 秒を含む値とstepの不一致:
08:15:30は有効な時刻の形式ですが、既定の60秒刻みには合いません。整数秒を許すならstep="1"を指定します placeholderが表示されない: ブラウザ仕様。ダミーテキストを期待しない- step 不一致エラー (stepMismatch): JS で
inputEl.stepUp()/stepDown()してもstepが大きすぎると失敗 - 深夜をまたぐ範囲:
type="time" min="22:00" max="02:00"は22時から翌2時までを表せます。仕様上の範囲と、対象ブラウザの操作を確認してください - 送信時の空文字列: 値が未入力で
requiredも付けず送信 → 空文字が飛ぶ。null 判定を忘れずに
高度なユースケース
React で “Controlled” に扱う
JavaScript
export default function TimeField() {
const [time, setTime] = useState('12:00');
return (
<>
<label htmlFor="start">開始時刻</label>
<input
id="start"
type="time"
value={time}
onChange={e => setTime(e.target.value)}
step={300}
min="09:00"
max="21:00"
/>
<span>{`→ 秒換算: ${toSeconds(time)}s`}</span>
</>
);
}
秒への換算は正規表現+分割で関数化して再利用するとバグを抑制できます。
Web Components でカスタム要素化
Shadow DOM 内に <input type="time"> をラップし、observedAttributes で min/max/step を動的管理。Form Associated Custom Elements を使えば <form> とネイティブ同等に連携可能です。
テストと QA チェックリスト
- フォーマット検証
- 空欄、範囲外の時刻、秒を含む値を試します。サーバー側の検証は、受け取る値の精度とそろえます
- ロケール差
- 英語・日本語・アラビア語 UI でラベルオーバーフローを確認
- アクセシビリティ
- キーボードのみで開始→値入力→送信→エラー確認の一連を完走
- 境界ケース
min=09:00 step=3600で09:59を入力 → エラー通知されるか- サマータイム
- TZ が DST 切替日に跨る場合、アプリ側でローカル値がずれないか
まとめ
<input type="time"> は ローカル時刻用の軽量 UI を半自動で提供してくれる便利要素ですが、
- 日付とタイムゾーンは含まない。秒は指定できる
placeholderが効かない- モバイル挙動が多様
といった制約を理解し、バリデーション・アクセシビリティ・フォールバック を組み合わせてはじめて “頑丈” なコンポーネントになります。
実運用では サーバー側での正規化 と テスト自動化 を最優先に据え、ユーザー体験を壊さないラインでネイティブ UI を活かしましょう。