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 long	DAY_MILLISECONDS
static String	defaultDateFormat
static String	defaultLocalDateFormat
static int	HOURS_PER_DAY
static int	MINUTES_PER_HOUR
static int	SECONDS_PER_DAY
static int	SECONDS_PER_MINUTE

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 Calendar	getJavaCalendar(double date, boolean use1904windowing, TimeZone timeZone, boolean roundSeconds) Get EXCEL date as Java Calendar with given time zone.
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 boolean	isValidExcelDate(double value) Given a double, checks if it is a valid Excel date.
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 void	setCalendar(Calendar calendar, int wholeDays, int millisecondsInDay, boolean use1904windowing, boolean roundSeconds)
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

SECONDS_PER_MINUTE

public static final int SECONDS_PER_MINUTE

See Also:

Constant Field Values

MINUTES_PER_HOUR

public static final int MINUTES_PER_HOUR

See Also:

Constant Field Values

HOURS_PER_DAY

public static final int HOURS_PER_DAY

See Also:

Constant Field Values

SECONDS_PER_DAY

public static final int SECONDS_PER_DAY

See Also:

Constant Field Values

DAY_MILLISECONDS

public static final long DAY_MILLISECONDS

See Also:

Constant Field Values

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

getJavaCalendar

public static Calendar getJavaCalendar(double date,
                                       boolean use1904windowing,
                                       TimeZone timeZone,
                                       boolean roundSeconds)

Get EXCEL date as Java Calendar with given time zone.

Parameters:

date - The Excel date.

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

timeZone - The TimeZone to evaluate the date in

roundSeconds - round to closest second

Returns:

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

setCalendar

public static void setCalendar(Calendar calendar,
                               int wholeDays,
                               int millisecondsInDay,
                               boolean use1904windowing,
                               boolean roundSeconds)

isValidExcelDate

public static boolean isValidExcelDate(double value)

Given a double, checks if it is a valid Excel date.

Parameters:

value - the double value

Returns:

true if valid

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()