JavaのTimestampクラスの使い方を現役エンジニアが解説【初心者向け】

JavaのTimestampクラスの使い方について解説します。実際にプログラムを書いて説明しているので、ぜひ理解しておきましょう。

 

そもそもJavaについてよく分からないという方は、Javaとは何なのか解説した記事を読むとさらに理解が深まります。
 

なお本記事は、TechAcademyのオンラインブートキャンプJava講座の内容をもとに作成しています。

 

 

 

Timestampクラスとは

java.sql.Timestamp は Date/Time API と呼ばれるjava.util.Dateのサブクラスです。java.util.Dateは日時情報を秒まで保持できますが、java.sql.Timestamp小数点以下の秒数値まで保持することができ、JDBC APIではこれをSQLのTIMESTAMP値として使うことができます。

 

現在日時をTimestamp型で取得する

現在日時を保持するTimestamp型オブジェクトを作成する場合、以下のコンストラクタを使います。

Timestamp(long time)

引数には1970年1月1日、0時0分0秒GMT (グリニッジ標準時)を起点とした時間をミリ秒で表した値を指定します。

import java.sql.Timestamp;

public class Sample {

  public static void main(String[] args) {

    //協定世界時のUTC 1970年1月1日深夜零時との差をミリ秒で取得
    long millis = System.currentTimeMillis();

    //ミリ秒
    System.out.println(millis);

    //ミリ秒を引数としてTimestampオブジェクトを作成
    Timestamp timestamp = new Timestamp(millis);

    //Timestampオブジェクトの値
    System.out.println(timestamp.toString());

  }

}

上記のサンプルではjava.lang.SystemクラスのcurrentTimeMillisメソッドを使用することで、グリニッジ標準時からの経過時間をミリ秒で取得します。尚ここで取得する値はオペレーティング・システムに依存します。その後、取得したミリ秒を引数としてTimestampオブジェクトを作成します。

実行すると

1561903826947
2019-06-30 23:10:26.947

※実行タイミングにより値は異なります。

が出力されます。
Timestampオブジェクトが、「yyyy-mm-dd hh:mm:ss.fff」という形で出力されていることが確認できます。
System.out.println(timestamp.toString());　の行で記述しているtoStringメソッドは、Timestampオブジェクトが保持する値を文字列として返却します。

 

[PR] 未経験からWebエンジニアを目指す方法とは

実際に書いてみよう

文字列からTimestampオブジェクトを作成することもできます。

import java.sql.Timestamp;

public class Sample {

  public static void main(String[] args) {

    //日時を文字列で指定
    String datetime = "2019-05-01 01:02:03.123456789";

    //Timestampオブジェクトへ変換
    Timestamp timestamp = Timestamp.valueOf(datetime);

    //出力
    System.out.println(timestamp.toString());

 

  }

}

秒数の小数点は9桁まで指定することができます。上記サンプルの実行結果は

2019-05-01 01:02:03.123456789

となります。指定する文字列は「yyyy-mm-dd hh:mm:ss.fffffffff」という形式である必要があります。

もし

String datetime = "2019年5月1日 01時02分03秒123";

のように、形式に沿わない指定をすると実行時にエラーとなります。

 

監修してくれたメンター

長屋雅美 独立系SIerで7年勤務後、現在はフリーのエンジニアとして自宅をオフィスとして活動しています。 JavaやC♯、shellscriptを用いた開発を主に担当し、TechAcademyではJavaコースを担当しています。

 

TechAcademyでは、初心者でもJavaやServletの技術を使ってWebアプリケーション開発を習得できるオンラインブートキャンプJava講座を開催しています。

挫折しない学習方法を知れる説明動画や、現役エンジニアとのビデオ通話とチャットサポート、学習用カリキュラムを体験できる無料体験も実施しているので、ぜひ参加してみてください。