ExcelDateUtils (Excel-CellFormatter 0.12 API)

java.lang.Object
- com.github.mygreen.cellformatter.lang.ExcelDateUtils

```
public class ExcelDateUtils
extends Object
```
Excelの日時表現を処理するためのユーティリティクラス。
- Excel上は、1900年は閏年扱いで、1900年2月29日が存在する。
- Javaの形式に変換したときは、1900年3月1日扱いとする。
導入されたバージョン:

0.6

作成者:

T.TSUCHIE

フィールドのサマリー

フィールド
修飾子とタイプ	フィールドと説明
`static long`	`MILLISECONDS_19000101` 1900-01-01 00:00:00.000の時間（単位はミリ秒）。
`static long`	`MILLISECONDS_19000301` 1900-03-01の時間（単位はミリ秒）。
`static long`	`MILLISECONDS_19040101` 1904-01-01 00:00:00.000の時間（単位はミリ秒）。
`static int`	`NON_LEAP_DAY` 1900年開始の場合、3月1日の経過日数。
`static int`	`OFFSET_DAYS_1900` Javaの基準日(=0)である1970年1月1日に対するExcelの基準日1900年1月0日の日のオフセット（単位は日）。
`static int`	`OFFSET_DAYS_1904` Javaの基準日(=0)である1970年1月1日に対するExcelの基準日1904年1月1日の日のオフセット（単位は日）。
`static int`	`SECONDS_IN_DAYS` 24時間の秒数。

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明

ExcelDateUtils()

コンストラクタ
コンストラクタと説明
`ExcelDateUtils()`

メソッドのサマリー

すべてのメソッド staticメソッド concreteメソッド
修飾子とタイプ	メソッドと説明
`static double`	`convertExcelNumber(Date value, boolean startDate1904)` Javaの`Date`型をExcelの内部表現の数値に変換する。
`static Date`	`convertJavaDate(double numValue, boolean startDate1904)` Excel表現上の数値をJavaの`Date`型(UTC形式)に変換する。
`static String`	`formatDate(Date date)` 日時形式をyyyy-MM-dd HH:mm:ss.SSSの書式でフォーマットする。
`static long`	`getExcelZeroDateTime(boolean isStartDate1904)` Excelの日付となる（=数値では0の値）の時の、時間の取得。
`static Date`	`parseDate(String str)` 文字列を日時形式をyyyy-MM-dd HH:mm:ss.SSSのパースする。

クラスから継承されたメソッド java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- フィールドの詳細
  - SECONDS_IN_DAYS
```
public static final int SECONDS_IN_DAYS
```
    24時間の秒数。
  - MILLISECONDS_19000101
```
public static final long MILLISECONDS_19000101
```
    1900-01-01 00:00:00.000の時間（単位はミリ秒）。
    Excelは設定により、1900年始まりか1904年始まりか指定できるため、その基準値として利用する。
  - MILLISECONDS_19040101
```
public static final long MILLISECONDS_19040101
```
    1904-01-01 00:00:00.000の時間（単位はミリ秒）。
    Excelは設定により、1900年始まりか1904年始まりか指定できるため、その基準値として利用する。
  - MILLISECONDS_19000301
```
public static final long MILLISECONDS_19000301
```
    1900-03-01の時間（単位はミリ秒）。
    Excelは1900年始まりの場合、閏日でない1900年2月29日（=3月1日）が存在するため、その基準値として利用する。
  - OFFSET_DAYS_1900
```
public static final int OFFSET_DAYS_1900
```
    Javaの基準日(=0)である1970年1月1日に対するExcelの基準日1900年1月0日の日のオフセット（単位は日）。
    ただし、Excelは1900年は1月0日から始まり、実質1899年12月31日となる。
  - OFFSET_DAYS_1904
```
public static final int OFFSET_DAYS_1904
```
    Javaの基準日(=0)である1970年1月1日に対するExcelの基準日1904年1月1日の日のオフセット（単位は日）。
  - NON_LEAP_DAY
```
public static final int NON_LEAP_DAY
```
    1900年開始の場合、3月1日の経過日数。
    1900年は閏年ではないが、Excelの場合は閏年扱いのため、 1900年1月～2月の期間（60日23時59分59秒=60.9999）を表現するための定数として利用する。
    
    関連項目:
    
    定数フィールド値
- コンストラクタの詳細
  - ExcelDateUtils
```
public ExcelDateUtils()
```
- メソッドの詳細
  - convertJavaDate
```
public static Date convertJavaDate(double numValue,
                                   boolean startDate1904)
```
    Excel表現上の数値をJavaのDate型(UTC形式)に変換する。
    1900年始まりの場合は以下の注意が必要。
    - 値0.0は、Excel上は1900年1月0日であるが、Date型へ変換した場合は1899年12月31日となります。
    - 値60.0は、Excel上は1900年2月29日だが、グレゴリオ歴上は閏日ではあにため、1900年3月1日となります。
    パラメータ:
    
    numValue - 変換対象のExcel表現上の数値。
    
    startDate1904 - 基準日が1904年始まりかどうか。
    
    戻り値:
    
    Java表現上に変換した日時。ただし、この値はタイムゾーンは考慮されていない（=GMT-00:00）ため、変換後は独自に処理を行う必要があります。
  - convertExcelNumber
```
public static double convertExcelNumber(Date value,
                                        boolean startDate1904)
```
    JavaのDate型をExcelの内部表現の数値に変換する。
    小数の桁数に関する注意事項。
    - このメソッドは少数は第16位まで保証し、小数第17位は四捨五入して計算します。
    - Excelの1秒は、UTC上では1/(60x60x24x1000)=0.0000000115741=1.15741e-008であるので、小数13位までの精度が必要。
    - Excelは秒までだが、Javaはミリ秒まで存在するので、さらに3桁多い、16桁までの精度が必要になる。
    1900年始まりの場合は以下の注意が必要。
    - UTC上は1900年2月29日は存在しないため、60.0への変換はできません。
    パラメータ:
    
    value - 変換対象のJava表現上の日時。タイムゾーンを排除した（GMT-00:00）日時。
    
    startDate1904 - 基準日が1904年始まりかどうか。
    
    戻り値:
    
    Excel表現上に変換した数値。
    
    例外:
    
    IllegalArgumentException - value == nulll.
  - formatDate
```
public static String formatDate(Date date)
```
    日時形式をyyyy-MM-dd HH:mm:ss.SSSの書式でフォーマットする。
    ただし、タイムゾーンは、標準時間のGMT-00:00で処理する。
    
    パラメータ:
    
    date - フォーマット対象の日時。
    
    戻り値:
    
    フォーマットした文字列。
    
    例外:
    
    IllegalArgumentException - date is null.
  - parseDate
```
public static Date parseDate(String str)
```
    文字列を日時形式をyyyy-MM-dd HH:mm:ss.SSSのパースする。
    ただし、タイムゾーンは、標準時間のGMT-00:00で処理する。
    
    パラメータ:
    
    str - パース対象の文字列
    
    戻り値:
    
    パースした日付。
    
    例外:
    
    IllegalArgumentException - str is empty.
    
    IllegalStateException - fail parsing.
  - getExcelZeroDateTime
```
public static long getExcelZeroDateTime(boolean isStartDate1904)
```
    Excelの日付となる（=数値では0の値）の時の、時間の取得。（単位はミリ秒）。
    1900年始まりの場合、Excelでは1月0日から始まるため、1899-12-31 00:00:00.000の値を返す。
    1904年始まりは、1904-01-01 0:00:00の値を返す。
    引数により、1904年始まりの場合の値か選択できる。
    
    パラメータ:
    
    isStartDate1904 - 1904年始まりかどうか。
    
    戻り値:
    
    Excelの基準日に対するUTC表現上のミリ秒。

クラス ExcelDateUtils

フィールドのサマリー

コンストラクタのサマリー

メソッドのサマリー

クラスから継承されたメソッド java.lang.Object

フィールドの詳細

SECONDS_IN_DAYS

MILLISECONDS_19000101

MILLISECONDS_19040101

MILLISECONDS_19000301

OFFSET_DAYS_1900

OFFSET_DAYS_1904

NON_LEAP_DAY

コンストラクタの詳細

ExcelDateUtils

メソッドの詳細

convertJavaDate

convertExcelNumber

formatDate

parseDate

getExcelZeroDateTime