DateInfo

Class DateInfo

java.lang.Object

com.grapecity.documents.excel.DateInfo

---

public final class DateInfo extends Object

提供在 OADate 值和 Java 日期时间类型之间转换的帮助方法。

当需要在 Java 代码和 Excel/OLE Automation 使用的数字日期表示形式之间交换日期值时，请使用此类型。

示例：

 LocalDateTime appointment = LocalDateTime.of(2024, 1, 15, 8, 30);
 double oaDate = DateInfo.ToOADate(appointment);
 LocalDateTime restored = DateInfo.FromOADateAsLocalDateTime(oaDate);
 

• Constructor Summary

  Constructors

  Constructor

  Description

  DateInfo()

   

• Method Summary

  All MethodsStatic MethodsConcrete MethodsDeprecated Methods

  Modifier and Type

  Method

  Description

  static Date

  FromOADate(double value)

  Deprecated.

  Use FromOADateAsLocalDateTime(double) instead.

  static LocalDateTime

  FromOADateAsLocalDateTime(double value)

  根据 OADate 值获取 LocalDateTime。

  static double

  ToOADate(LocalDateTime localDateTime)

  根据 LocalDateTime 获取 OADate 值。

  static double

  ToOADate(Calendar calendar)

  根据 Calendar 获取 OADate 值。

  static double

  ToOADate(Date date)

  获取 Date 的 OADate 值。

  Methods inherited from class java.lang.Object

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

• Constructor Details

  • DateInfo

    public DateInfo()

• Method Details

  • ToOADate

    public static double ToOADate(Date date)

    获取 Date 的 OADate 值。

    使用此方法可以将 Java Date 值转换为 Excel 和 OLE Automation 使用的数字日期表示形式。

    
     Calendar calendar = new GregorianCalendar(2024, Calendar.JANUARY, 15, 8, 30, 0);
     Date date = calendar.getTime();
     double oaDate = DateInfo.ToOADate(date);
     

    Parameters:

    date - 要转换的 Date 对象。

    Returns:

    与指定 Date 对应的 OADate 值。

  • ToOADate

    public static double ToOADate(Calendar calendar)

    根据 Calendar 获取 OADate 值。

    使用此方法可以将 Java 日历值转换为 Excel 使用的数字日期表示形式。

    
     Calendar calendar = Calendar.getInstance();
     calendar.set(2024, Calendar.JANUARY, 15, 8, 30, 0);
     calendar.set(Calendar.MILLISECOND, 0);
     double oaDate = DateInfo.ToOADate(calendar);
     

    Parameters:

    calendar - 要转换的 Calendar 对象。

    Returns:

    OADate 的值。

  • ToOADate

    public static double ToOADate(LocalDateTime localDateTime)

    根据 LocalDateTime 获取 OADate 值。

    使用此方法可以将 Java 日期时间值转换为 Excel 使用的数字日期表示形式。

    
     LocalDateTime localDateTime = LocalDateTime.of(2024, 1, 15, 8, 30);
     double oaDate = DateInfo.ToOADate(localDateTime);
     

    Parameters:

    localDateTime - 要转换的 LocalDateTime 对象。

    Returns:

    OADate 的值。

  • FromOADate

    @Deprecated public static Date FromOADate(double value)

    Deprecated.

    Use FromOADateAsLocalDateTime(double) instead.

    将 OADate 值转换为 Date。

    此方法返回与指定 OADate 值对应的 Date。

    Parameters:

    value - 要转换的 OADate 值。

    Returns:

    与指定 OADate 值对应的 Date。

  • FromOADateAsLocalDateTime

    public static LocalDateTime FromOADateAsLocalDateTime(double value)

    根据 OADate 值获取 LocalDateTime。

    使用此方法可以将 OLE Automation 日期值转换为 LocalDateTime。要将 LocalDateTime 转换回 OADate 值，请使用ToOADate(LocalDateTime)。

    
     double oaDate = 45292.5;
     LocalDateTime dateTime = DateInfo.FromOADateAsLocalDateTime(oaDate);
     int hour = dateTime.getHour();
     

    Parameters:

    value - 要转换的 OADate 值。

    Returns:

    对应的 LocalDateTime。