com.alibaba.excel.util

Class DateUtils

java.lang.Object

com.alibaba.excel.util.DateUtils

public class DateUtils
extends Object

Date utils

Author:

Jiaju Zhuang

Field Summary

Fields

Modifier and Type	Field and Description
static String	DATE_FORMAT_10
static String	DATE_FORMAT_14
static String	DATE_FORMAT_16
static String	DATE_FORMAT_16_FORWARD_SLASH
static String	DATE_FORMAT_17
static String	DATE_FORMAT_19
static String	DATE_FORMAT_19_FORWARD_SLASH
static String	defaultDateFormat
static String	defaultLocalDateFormat

Method Summary

Modifier and Type	Method and Description
static String	format(BigDecimal date, Boolean use1904windowing, String dateFormat) Format date
static String	format(Date date) Format date
static String	format(Date date, String dateFormat) Format date
static String	format(LocalDate date, String dateFormat) Format date
static String	format(LocalDate date, String dateFormat, Locale local) Format date
static String	format(LocalDateTime date, String dateFormat) Format date
static String	format(LocalDateTime date, String dateFormat, Locale local) Format date
static Date	getJavaDate(double date, boolean use1904windowing) Given an Excel date with either 1900 or 1904 date windowing, converts it to a java.util.Date.
static LocalDate	getLocalDate(double date, boolean use1904windowing) Given an Excel date with either 1900 or 1904 date windowing, converts it to a java.time.LocalDate.
static LocalDateTime	getLocalDateTime(double date, boolean use1904windowing) Given an Excel date with either 1900 or 1904 date windowing, converts it to a java.time.LocalDateTime.
static boolean	isADateFormat(Short formatIndex, String formatString) Determine if it is a date format.
static boolean	isADateFormatUncached(Short formatIndex, String formatString) Determine if it is a date format.
static boolean	isInternalDateFormat(short format) Given a format ID this will check whether the format represents an internal excel date format or not.
static Date	parseDate(String dateString) convert string to date
static Date	parseDate(String dateString, String dateFormat) convert string to date
static LocalDate	parseLocalDate(String dateString, String dateFormat, Locale local) convert string to date
static LocalDateTime	parseLocalDateTime(String dateString, String dateFormat, Locale local) convert string to date
static void	removeThreadLocalCache()
static String	switchDateFormat(String dateString) switch date format

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DATE_FORMAT_10

public static final String DATE_FORMAT_10

See Also:

Constant Field Values

DATE_FORMAT_14

public static final String DATE_FORMAT_14

See Also:

Constant Field Values

DATE_FORMAT_16

public static final String DATE_FORMAT_16

See Also:

Constant Field Values

DATE_FORMAT_16_FORWARD_SLASH

public static final String DATE_FORMAT_16_FORWARD_SLASH

See Also:

Constant Field Values

DATE_FORMAT_17

public static final String DATE_FORMAT_17

See Also:

Constant Field Values

DATE_FORMAT_19

public static final String DATE_FORMAT_19

See Also:

Constant Field Values

DATE_FORMAT_19_FORWARD_SLASH

public static final String DATE_FORMAT_19_FORWARD_SLASH

See Also:

Constant Field Values

defaultDateFormat

public static String defaultDateFormat

defaultLocalDateFormat

public static String defaultLocalDateFormat

Method Detail

parseDate

public static Date parseDate(String dateString,
                             String dateFormat)
                      throws ParseException

convert string to date

Parameters:

dateString -

dateFormat -

Returns:

Throws:

ParseException

parseLocalDateTime

public static LocalDateTime parseLocalDateTime(String dateString,
                                               String dateFormat,
                                               Locale local)

convert string to date

Parameters:

dateString -

dateFormat -

local -

Returns:

parseLocalDate

public static LocalDate parseLocalDate(String dateString,
                                       String dateFormat,
                                       Locale local)

convert string to date

Parameters:

dateString -

dateFormat -

local -

Returns:

parseDate

public static Date parseDate(String dateString)
                      throws ParseException

convert string to date

Parameters:

dateString -

Returns:

Throws:

ParseException

switchDateFormat

public static String switchDateFormat(String dateString)

switch date format

Parameters:

dateString -

Returns:

format

public static String format(Date date)

Format date

yyyy-MM-dd HH:mm:ss

Parameters:

date -

Returns:

format

public static String format(Date date,
                            String dateFormat)

Format date

Parameters:

date -

dateFormat -

Returns:

format

public static String format(LocalDateTime date,
                            String dateFormat,
                            Locale local)

Format date

Parameters:

date -

dateFormat -

Returns:

format

public static String format(LocalDate date,
                            String dateFormat)

Format date

Parameters:

date -

dateFormat -

Returns:

format

public static String format(LocalDate date,
                            String dateFormat,
                            Locale local)

Format date

Parameters:

date -

dateFormat -

Returns:

format

public static String format(LocalDateTime date,
                            String dateFormat)

Format date

Parameters:

date -

dateFormat -

Returns:

format

public static String format(BigDecimal date,
                            Boolean use1904windowing,
                            String dateFormat)

Format date

Parameters:

date -

dateFormat -

Returns:

getJavaDate

public static Date getJavaDate(double date,
                               boolean use1904windowing)

Given an Excel date with either 1900 or 1904 date windowing, converts it to a java.util.Date. Excel Dates and Times are stored without any timezone information. If you know (through other means) that your file uses a different TimeZone to the system default, you can use this version of the getJavaDate() method to handle it.

Parameters:

date - The Excel date.

use1904windowing - true if date uses 1904 windowing, or false if using 1900 date windowing.

Returns:

Java representation of the date, or null if date is not a valid Excel date

getLocalDateTime

public static LocalDateTime getLocalDateTime(double date,
                                             boolean use1904windowing)

Given an Excel date with either 1900 or 1904 date windowing, converts it to a java.time.LocalDateTime. Excel Dates and Times are stored without any timezone information. If you know (through other means) that your file uses a different TimeZone to the system default, you can use this version of the getJavaDate() method to handle it.

Parameters:

date - The Excel date.

use1904windowing - true if date uses 1904 windowing, or false if using 1900 date windowing.

Returns:

Java representation of the date, or null if date is not a valid Excel date

getLocalDate

public static LocalDate getLocalDate(double date,
                                     boolean use1904windowing)

Given an Excel date with either 1900 or 1904 date windowing, converts it to a java.time.LocalDate. Excel Dates and Times are stored without any timezone information. If you know (through other means) that your file uses a different TimeZone to the system default, you can use this version of the getJavaDate() method to handle it.

Parameters:

date - The Excel date.

use1904windowing - true if date uses 1904 windowing, or false if using 1900 date windowing.

Returns:

Java representation of the date, or null if date is not a valid Excel date

isADateFormat

public static boolean isADateFormat(Short formatIndex,
                                    String formatString)

Determine if it is a date format.

Parameters:

formatIndex -

formatString -

Returns:

isADateFormatUncached

public static boolean isADateFormatUncached(Short formatIndex,
                                            String formatString)

Determine if it is a date format.

Parameters:

formatIndex -

formatString -

Returns:

isInternalDateFormat

public static boolean isInternalDateFormat(short format)

Given a format ID this will check whether the format represents an internal excel date format or not.

See Also:

isADateFormat(Short, String)

removeThreadLocalCache

public static void removeThreadLocalCache()