JavaScriptでDatepickerを使う方法を現役エンジニアが解説【初心者向け】
初心者向けにJavaScriptでDatepickerを使う方法について現役エンジニアが解説しています。Datepickerとは日付を選択する部品のことで、カレンダーなどで使われています。jQueryやjQueryUI、jQueryUIのCSSを使って実現します。
テックアカデミーマガジンは受講者数No.1のプログラミングスクール「テックアカデミー」が運営。初心者向けにプロが解説した記事を公開中。現役エンジニアの方はこちらをご覧ください。 ※ アンケートモニター提供元：GMOリサーチ株式会社 調査期間：2021年8月12日～8月16日 調査対象：2020年8月以降にプログラミングスクールを受講した18～80歳の男女1,000名 調査手法：インターネット調査
この記事を書いた人
テックアカデミーマガジン編集部
Web制作をしていると、日付の入力欄を作りたいときがあります。
テキストで入力するのではなく、カレンダーで選択できたら便利ですよね。
本記事では、カレンダーで日付選択するWebの部品、DatePickerの作り方について、テックアカデミーのメンター（現役エンジニア）が実際のコードを使用して初心者向けに解説します。
作り方がわからない、何を使って作るか悩むという方はぜひ読んでみてください。
目次
そもそもJavaScriptについてよく分からないという方は、JavaScriptとは何なのかについて解説した記事を読むとさらに理解が深まります。
今回は、JavaScriptに関する内容だね！
どういう内容でしょうか？
JavaScriptでDatePickerを使う方法について詳しく説明していくね！
お願いします！
DatePickerとは
日付を選択する部品のことです。
下記の画像のように、カレンダーを表示して選択した日付が入力欄に入ります。
これにより、ユーザーに日付を楽に入力してもらうことができます。
DatePickerを作る様々な手法
DatePickerを作るには様々な手法があり、どの手法を使うか迷ってしまいます。
jQueryやBootstrap、Vueなど様々なJavaScriptライブラリがあり、またHTML5だけでも作れます。
See the Pen
DapePickerNoJS by TAKAYOSHI (@lspuwbkv)
on CodePen.
ただし、2021年現在、HTML5標準のDatePickerを実務レベルで使うのはおすすめしません。
新しく策定された機能で、まだブラウザの実装が追い付いておらず、Safaliなどで使えないからです。
（引用 Can I Use : Date and time input types）
将来的に全ブラウザで対応するまで、今のところはJavaScriptライブラリを使いましょう。
本記事では、普及していて使いやすいライブラリである、jQuery UIを使ってDatePickerを作ります。
jQuery UIでDatePickerを作ってみよう
jQuery UIを使ってDatePickerを作るサンプルコードがこちらです。
See the Pen
date picker by TAKAYOSHI (@lspuwbkv)
on CodePen.
JavaScript
$('#datepicker').datepicker();
JavaScriptのコードは1行だけで、とてもシンプルですね。
jQuery UI はjQueryの拡張ライブラリで、様々なWebの部品を簡単に作ることができます。
jQuery UI のようなライブラリを利用するために、HTMLでライブラリファイルを読み込みます。
HTML
<!--jQuery JS--> <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.6.0/jquery.min.js" /></script> <!--jQuery UI JS--> <script src="https://cdnjs.cloudflare.com/ajax/libs/jqueryui/1.12.1/jquery-ui.min.js"></script> <!--jQuery UI CSS--> <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/jqueryui/1.12.1/themes/base/jquery-ui.min.css">
jQuery UI では、「jQuery本体のJS」「jQuery UIのJS」「jQuery UIのCSS」の3つを読み込んで使います。
また、追加でテーマ と呼ばれるスタイルを読み込んで、カスタマイズすることもできるんです。
その後、DataPickerにするためのinput要素を作り、IDを割り振ります。
HTML
<!--Date picker element--> <input type="text" id="datepicker">
HTMLを準備したら、JavaScriptではjQueryでinput要素をセレクト、datapicker()メソッドを呼び出します。
JavaScript
$('#datepicker').datepicker();
これでDatePickerを作ることができました、簡単ですね。
DatePickerのオプション
DatePickerは日付のフォーマットを変更したり、月の表示を「1月、2月・・・」と日本語にしたり、豊富なオプションが用意されているんです。
オプションの一例
| オプション | 機能 |
| dateFormat | 日時の表示形式 |
| monthNames | 月の表示名 |
| defaultDate | 初期値の日付 |
| firstDay | 週の始まりの曜日 |
様々な細かい挙動を、datapicker()メソッドの引数にオプションで指定してコントロールするのです。
$('#datepicker').datepicker({
/*日付フォーマット*/
dateFormat: 'yy-mm-dd',
/*初期値*/
defaultDate: '1999-12-31',
/*月の表示を日本語に*/
monthNames: [ "1月", "2月", "3月", "4月", "5月", "6月", "7月", "8月", "9月", "10月", "11月", "12月" ]
});
See the Pen
Datepicker with op by TAKAYOSHI (@lspuwbkv)
on CodePen.
オプションはjQuery UIを翻訳したサイトのオプション一覧ページが見やすいのでそちらで確認してみてください。
まとめ
日付の入力を助けてくれるDatePickerは、必要なCSSとJSファイル2つを読み込めば、1行のJavaScriptコードで使用できます。
オプションで見た目や動作の変更も簡単です。
日付の入力欄には積極的に使ってみてください。
内容分かりやすくて良かったです！
ゆかりちゃんも分からないことがあったら質問してね！
分かりました。ありがとうございます！
JavaScriptを学習中の方へ
これで解説は終了です、お疲れさまでした。
- つまずかず「効率的に」学びたい
- 副業や転職後の「現場で使える」知識やスキルを身につけたい
プログラミングを学習していて、このように思ったことはありませんか？
テックアカデミーのフロントエンドコースでは、第一線で活躍する「プロのエンジニア」が教えているので、効率的に実践的なスキルを完全オンラインでしっかり習得できます。
合格率10%の選考を通過した、選ばれたエンジニアの手厚いサポートを受けながら、JavaScript・jQueryを使ったWebサービス開発を学べます。
まずは一度、無料体験で学習の悩みや今後のキャリアについて話してみて、「現役エンジニアから教わること」を実感してみてください。
時間がない方、深く知ってから体験してみたい方は、今スグ見られる説明動画から先に視聴することをおすすめします！
