DateComponents (OREKIT 12.0.1 API)

java.lang.Object
- org.orekit.time.DateComponents

All Implemented Interfaces:

Serializable, Comparable<DateComponents>
```
public class DateComponents
extends Object
implements Serializable, Comparable<DateComponents>
```
表示日期的类，以年、月和日组件拆分。
此类使用天文约定的日历，这也是java.util.Date使用的约定：年零位于年份-1和+1之间，并且1582年缺少10天。在这些特殊日期周围使用的日历是：
- 0000-12-31之前：普罗利普提克朱利安历
- 从0001-01-01到1582-10-04：朱利安历
- 从1582-10-15起：公历
此类的实例保证是不可变的。
Author:

Luc Maisonobe

See Also:

TimeComponents, DateTimeComponents, Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static DateComponents`	`BEIDOU_EPOCH` 北斗周的参考时期：2006-01-01。
`static DateComponents`	`CCSDS_EPOCH` CCSDS时间代码格式（CCSDS 301.0-B-4）的参考时期：1958-01-01。
`static DateComponents`	`FIFTIES_EPOCH` 1950年日期的参考时期：1950-01-01。
`static DateComponents`	`GALILEO_EPOCH` 伽利略系统时间的参考时期：1999-08-22。
`static DateComponents`	`GLONASS_EPOCH` 格洛纳斯四年间隔编号的参考时期：1996-01-01。
`static DateComponents`	`GPS_EPOCH` GPS周的参考时期：1980-01-06。
`static DateComponents`	`IRNSS_EPOCH` IRNSS周的参考时期：1999-08-22。
`static DateComponents`	`J2000_EPOCH` J2000.0参考时期：2000-01-01。
`static DateComponents`	`JAVA_EPOCH` Java参考时期：1970-01-01。
`static DateComponents`	`JULIAN_EPOCH` 朱利安日期的参考时期：-4712-01-01。
`static DateComponents`	`MAX_EPOCH` 最大支持日期。
`static DateComponents`	`MIN_EPOCH` 最大支持日期。
`static DateComponents`	`MODIFIED_JULIAN_EPOCH` 修改儒略日期的参考时期：1858-11-17。
`static DateComponents`	`QZSS_EPOCH` QZSS周的参考时期：1980-01-06。

Constructor Summary

Constructors
Constructor and Description
`DateComponents(DateComponents epoch, int offset)` 根据与参考时期的偏移量构建日期。
`DateComponents(int offset)` 根据与`J2000_EPOCH`的偏移量构建日期。
`DateComponents(int year, int dayNumber)` 根据年份和日期编号构建日期。
`DateComponents(int year, int month, int day)` 根据其组件构建日期。
`DateComponents(int year, Month month, int day)` 根据其组件构建日期。

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`int`	`compareTo(DateComponents other)`
`static DateComponents`	`createFromWeekComponents(int wYear, int week, int dayOfWeek)` 根据周组件构建日期。
`boolean`	`equals(Object other)`
`int`	`getCalendarWeek()` 获取日历周编号。
`int`	`getDay()` 获取日。
`int`	`getDayOfWeek()` 获取星期几。
`int`	`getDayOfYear()` 获取年份中的日期编号。
`int`	`getJ2000Day()` 获取相对于J2000时期的日期编号。
`int`	`getMJD()` 获取修改儒略日。
`int`	`getMonth()` 获取月份。
`Month`	`getMonthEnum()` 以枚举形式获取月份。
`int`	`getYear()` 获取年份。
`int`	`hashCode()`
`static DateComponents`	`parseDate(String string)` 解析ISO-8601格式的字符串以构建日期。
`String`	`toString()` 获取日期的字符串表示（ISO-8601）。

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - JULIAN_EPOCH
```
public static final DateComponents JULIAN_EPOCH
```
    朱利安日期的参考时期：-4712-01-01。
    java.util.Date和DateComponents类都遵循天文约定，并考虑年份-1和+1之间的年份0，因此此参考日期位于年份-4712而不是其他遵循不同约定的文档或程序中的年份-4713（例如convcal实用程序）。
  - MODIFIED_JULIAN_EPOCH
```
public static final DateComponents MODIFIED_JULIAN_EPOCH
```
    修改儒略日期的参考时期：1858-11-17。
  - FIFTIES_EPOCH
```
public static final DateComponents FIFTIES_EPOCH
```
    1950年日期的参考时期：1950-01-01。
  - CCSDS_EPOCH
```
public static final DateComponents CCSDS_EPOCH
```
    CCSDS时间代码格式（CCSDS 301.0-B-4）的参考时期：1958-01-01。
  - GALILEO_EPOCH
```
public static final DateComponents GALILEO_EPOCH
```
    伽利略系统时间的参考时期：1999-08-22。
  - GPS_EPOCH
```
public static final DateComponents GPS_EPOCH
```
    GPS周的参考时期：1980-01-06。
  - QZSS_EPOCH
```
public static final DateComponents QZSS_EPOCH
```
    QZSS周的参考时期：1980-01-06。
  - IRNSS_EPOCH
```
public static final DateComponents IRNSS_EPOCH
```
    IRNSS周的参考时期：1999-08-22。
  - BEIDOU_EPOCH
```
public static final DateComponents BEIDOU_EPOCH
```
    北斗周的参考时期：2006-01-01。
  - GLONASS_EPOCH
```
public static final DateComponents GLONASS_EPOCH
```
    格洛纳斯四年间隔编号的参考时期：1996-01-01。
  - J2000_EPOCH
```
public static final DateComponents J2000_EPOCH
```
    J2000.0参考时期：2000-01-01。
  - JAVA_EPOCH
```
public static final DateComponents JAVA_EPOCH
```
    Java参考时期：1970-01-01。
  - MAX_EPOCH
```
public static final DateComponents MAX_EPOCH
```
    最大支持日期。
    这是日期5881610-07-11，对应于J2000_EPOCH之后Integer.MAX_VALUE天。
    
    自版本:
    
    9.0
  - MIN_EPOCH
```
public static final DateComponents MIN_EPOCH
```
    最大支持日期。
    这是日期-5877490-03-03，对应于J2000_EPOCH之前Integer.MIN_VALUE天。
    
    自版本:
    
    9.0
- Constructor Detail
  - DateComponents
```
public DateComponents(int year,
                      int month,
                      int day)
               throws IllegalArgumentException
```
    根据其组件构建日期。
    
    参数:
    
    year - 年份（BC年份可能为0或负数）
    
    month - 月份，从1到12
    
    day - 日期，从1到31
    
    抛出:
    
    IllegalArgumentException - 如果给定不一致的参数（参数超出范围，非闰年的2月29日，1582年的公历闰年期间的日期等）
  - DateComponents
```
public DateComponents(int year,
                      Month month,
                      int day)
               throws IllegalArgumentException
```
    根据其组件构建日期。
    
    参数:
    
    year - 年份（BC年份可能为0或负数）
    
    month - 月份枚举
    
    day - 日期，从1到31
    
    抛出:
    
    IllegalArgumentException - 如果给定不一致的参数（参数超出范围，非闰年的2月29日，1582年的公历闰年期间的日期等）
  - DateComponents
```
public DateComponents(int year,
                      int dayNumber)
               throws IllegalArgumentException
```
    根据年份和日期编号构建日期。
    
    参数:
    
    year - 年份（BC年份可能为0或负数）
    
    dayNumber - 年份中的日期编号，从1到366
    
    抛出:
    
    IllegalArgumentException - 如果日期编号超出年份范围
  - DateComponents
```
public DateComponents(int offset)
```
    根据与J2000_EPOCH的偏移量构建日期。
    
    参数:
    
    offset - 相对于J2000_EPOCH的偏移量
    
    另请参阅:
    
    getJ2000Day()
  - DateComponents
```
public DateComponents(DateComponents epoch,
                      int offset)
```
    根据与参考时期的偏移量构建日期。
    此构造函数主要用于从修改儒略日（使用MODIFIED_JULIAN_EPOCH）或GPS周数（使用GPS_EPOCH）构建日期。
    
    参数:
    
    epoch - 参考时期
    
    offset - 相对于参考时期的偏移量
    
    另请参阅:
    
    DateComponents(int), getMJD()
- Method Detail
  - createFromWeekComponents
```
public static DateComponents createFromWeekComponents(int wYear,
                                                      int week,
                                                      int dayOfWeek)
                                               throws IllegalArgumentException
```
    根据周组件构建日期。
    日历周编号是1到52或53之间的数字，具体取决于年份。根据ISO定义，第1周是包含一年中第一个星期四的周。因此，第1周可能从前一年开始，第52周或第53周可能在下一年结束。例如，日历日期1995-01-01对应于周日期1994-W52-7（即1994年最后一周的星期日实际上是1995年的第一天）。另一个例子是日历日期1996-12-31对应于周日期1997-W01-2（即1997年第一周的星期二实际上是1996年的最后一天）。
    
    参数:
    
    wYear - 与周编号相关的年份
    
    week - 一年中的周数，从1到52或53
    
    dayOfWeek - 星期几，从1（星期一）到7（星期日）
    
    返回:
    
    一个构建的日期
    
    抛出:
    
    IllegalArgumentException - 如果给定不一致的参数（参数超出范围，在52周年中的第53周等）
  - parseDate
```
public static DateComponents parseDate(String string)
```
    解析ISO-8601格式的字符串以构建日期。
    支持的格式包括：
    - 基本格式日历日期：YYYYMMDD
    - 扩展格式日历日期：YYYY-MM-DD
    - 基本格式序数日期：YYYYDDD
    - 扩展格式序数日期：YYYY-DDD
    - 基本格式周日期：YYYYWwwD
    - 扩展格式周日期：YYYY-Www-D
    如上述列表所示，仅支持ISO-8601标准第4.1节中定义的完整表示，不支持扩展表示或精度降低的表示。
    
    不支持将单个整数解析为儒略日，因为这可能与基本格式日历日期或基本格式序数日期中的一个存在歧义，具体取决于数字位数。
    参数:
    
    string - 要解析的字符串
    
    返回:
    
    解析后的日期
    
    抛出:
    
    IllegalArgumentException - 如果无法解析字符串
  - getYear
```
public int getYear()
```
    获取年份。
    
    返回:
    
    年份（BC年份可能为0或负数）
  - getMonth
```
public int getMonth()
```
    获取月份。
    
    返回:
    
    月份，从1到12
  - getMonthEnum
```
public Month getMonthEnum()
```
    以枚举形式获取月份。
    
    返回:
    
    月份作为枚举
  - getDay
```
public int getDay()
```
    获取日。
    
    返回:
    
    从1到31的日期数字
  - getJ2000Day
```
public int getJ2000Day()
```
    获取相对于J2000时代的日期数字。
    
    返回:
    
    相对于J2000时代的日期数字
  - getMJD
```
public int getMJD()
```
    获取修正儒略日。
    
    返回:
    
    修正儒略日
  - getCalendarWeek
```
public int getCalendarWeek()
```
    获取日历周数。
    日历周数是1到52或53之间的数字，取决于年份。 ISO将第1周定义为包括一年中第一个星期四的周。因此，第1周可能从前一年开始，第52周或第53周可能在下一年结束。例如，日历日期1995-01-01对应于周日期1994-W52-7（即1994年最后一周的星期日实际上是1995年的第一天）。另一个例子是日历日期1996-12-31，对应于周日期1997-W01-2（即1997年第一周的星期二实际上是1996年的最后一天）。
    
    返回:
    
    日历周数
  - getDayOfWeek
```
public int getDayOfWeek()
```
    获取星期几。
    星期几是1（星期一）到7（星期日）之间的数字。
    
    返回:
    
    星期几
  - getDayOfYear
```
public int getDayOfYear()
```
    获取一年中的日期数字。
    一年中的日期数字介于1月1日和365或366之间，具体取决于年份。
    
    返回:
    
    一年中的日期数字
  - toString
```
public String toString()
```
    获取日期的字符串表示（ISO-8601）。
    
    覆盖:
    
    toString 在类 Object中
    
    返回:
    
    日期的字符串表示。
  - compareTo
```
public int compareTo(DateComponents other)
```
    指定者:
    
    compareTo 在接口 Comparable<DateComponents>中
  - equals
```
public boolean equals(Object other)
```
    覆盖:
    
    equals 在类 Object中
  - hashCode
```
public int hashCode()
```
    覆盖:
    
    hashCode 在类 Object中

Class DateComponents

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

JULIAN_EPOCH

MODIFIED_JULIAN_EPOCH

FIFTIES_EPOCH

CCSDS_EPOCH

GALILEO_EPOCH

GPS_EPOCH

QZSS_EPOCH

IRNSS_EPOCH

BEIDOU_EPOCH

GLONASS_EPOCH

J2000_EPOCH

JAVA_EPOCH

MAX_EPOCH

MIN_EPOCH

Constructor Detail

DateComponents

DateComponents

DateComponents

DateComponents

DateComponents

Method Detail

createFromWeekComponents

parseDate

getYear

getMonth

getMonthEnum

getDay

getJ2000Day

getMJD

getCalendarWeek

getDayOfWeek

getDayOfYear

toString

compareTo

equals

hashCode