TimeComponents (OREKIT 12.0.1 API)

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

All Implemented Interfaces:

Serializable, Comparable<TimeComponents>
```
public class TimeComponents
extends Object
implements Serializable, Comparable<TimeComponents>
```
表示一天内的时间，由小时、分钟和秒组件组成。
此类的实例保证是不可变的。

Author:

Luc Maisonobe

See Also:

DateComponents, DateTimeComponents, Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static TimeComponents`	`H00` 常用的时间00:00:00的常量。
`static TimeComponents`	`H12` 常用的时间12:00:00的常量。

Constructor Summary

Constructors
Constructor and Description
`TimeComponents(double secondInDay)` 从一天内的秒数构建时间。
`TimeComponents(int secondInDayA, double secondInDayB)` 从一天内的秒数构建时间。
`TimeComponents(int hour, int minute, double second)` 从其时钟元素构建时间。
`TimeComponents(int hour, int minute, double second, int minutesFromUTC)` 从其时钟元素构建时间。

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`int`	`compareTo(TimeComponents other)`
`boolean`	`equals(Object other)`
`String`	`formatUtcOffset()` 以ISO8601格式获取UTC偏移量的字符串。
`static TimeComponents`	`fromSeconds(int secondInDayA, double secondInDayB, double leap, int minuteDuration)` 从一天内的秒数构建时间。
`int`	`getHour()` 获取小时数。
`int`	`getMinute()` 获取分钟数。
`int`	`getMinutesFromUTC()` 获取指定日期与UTC之间的偏移量。
`double`	`getSecond()` 获取秒数。
`double`	`getSecondsInLocalDay()` 获取本地一天内的秒数，不应用`UTC偏移量`。
`double`	`getSecondsInUTCDay()` 获取UTC一天内的秒数，应用`UTC偏移量`。
`int`	`hashCode()`
`static TimeComponents`	`parseTime(String string)` 解析ISO-8601格式的字符串以构建时间。
`String`	`toString()` 获取包括UTC偏移量的时间的字符串表示。
`String`	`toStringWithoutUtcOffset()` 获取不包括UTC偏移量的时间的字符串表示。

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

- Field Detail
  - H00
```
public static final TimeComponents H00
```
    常用的时间00:00:00的常量。
  - H12
```
public static final TimeComponents H12
```
    常用的时间12:00:00的常量。
- Constructor Detail
  - TimeComponents
```
public TimeComponents(int hour,
                      int minute,
                      double second)
               throws IllegalArgumentException
```
    从其时钟元素构建时间。
    请注意，此方法允许60.0（包含）到61.0（不包含）之间的秒数，因为它们在UTC时间标度中引入闰秒时会出现。
    
    参数：
    
    hour - 从0到23的小时数
    
    minute - 从0到59的分钟数
    
    second - 从0.0到61.0（不包含）的秒数
    
    抛出：
    
    IllegalArgumentException - 如果给定的参数不一致（参数超出范围）
  - TimeComponents
```
public TimeComponents(int hour,
                      int minute,
                      double second,
                      int minutesFromUTC)
               throws IllegalArgumentException
```
    从其时钟元素构建时间。
    请注意，此方法允许60.0（包含）到61.0（不包含）之间的秒数，因为它们在UTC时间标度中引入闰秒时会出现。
    
    参数：
    
    hour - 从0到23的小时数
    
    minute - 从0到59的分钟数
    
    second - 从0.0到61.0（不包含）的秒数
    
    minutesFromUTC - 指定日期与UTC之间的偏移量，按照ISO-8601标准，以分钟为单位的整数
    
    抛出：
    
    IllegalArgumentException - 如果给定的参数不一致（参数超出范围）
    
    自：
    
    7.2
  - TimeComponents
```
public TimeComponents(double secondInDay)
               throws OrekitIllegalArgumentException
```
    从一天内的秒数构建时间。
    如果secondInDay小于60.0，那么getSecond()将小于60.0，否则它将小于61.0。在负闰秒期间，此构造函数可能会产生getSecond()的无效值，尽管从未发生过。要更好地控制最后一分钟的秒数，请使用fromSeconds(int, double, double, int)。
    
    此构造函数始终处于UTC时间（即将返回0）。
    
    参数：
    
    secondInDay - 从0.0到Constants.JULIAN_DAY + 1（不包含）的秒数
    
    抛出：
    
    OrekitIllegalArgumentException - 如果秒数超出范围
    
    另请参阅：
    
    fromSeconds(int, double, double, int)，TimeComponents(int, double)
  - TimeComponents
```
public TimeComponents(int secondInDayA,
                      double secondInDayB)
               throws OrekitIllegalArgumentException
```
    从一天内的秒数构建时间。
    这里定义的秒数是总和secondInDayA + secondInDayB，从0.0到Constants.JULIAN_DAY + 1（不包含）。这两个参数用于增加精度。
    
    如果总和小于60.0，那么getSecond()将小于60.0，否则它将小于61.0。在负闰秒期间，此构造函数可能会产生getSecond()的无效值，尽管从未发生过。要更好地控制最后一分钟的秒数，请使用fromSeconds(int, double, double, int)。
    
    此构造函数始终处于UTC时间（即getMinutesFromUTC()将返回0）。
    
    参数：
    
    secondInDayA - 秒数的第一部分
    
    secondInDayB - 秒数的最后一部分
    
    抛出：
    
    OrekitIllegalArgumentException - 如果秒数超出范围
    
    另请参阅：
    
    fromSeconds(int, double, double, int)
- Method Detail
  - fromSeconds
```
public static TimeComponents fromSeconds(int secondInDayA,
                                         double secondInDayB,
                                         double leap,
                                         int minuteDuration)
```
    从一天内的秒数构建时间。
    午夜后的秒数是总和secondInDayA + secondInDayB + leap。这两个参数用于增加精度。仅使用总和的第一部分（secondInDayA + secondInDayB）来计算小时和分钟。第三个参数（leap）直接添加到秒值（getSecond()）以实现闰秒。这三个量必须满足以下约束。第一个约束保证小时和分钟有效，第二个约束保证秒数有效。
```
      0 <= secondInDayA + secondInDayB < 86400
      0 <= (secondInDayA + secondInDayB) % 60 + leap <= minuteDuration
      0 <= leap <= minuteDuration - 60                        如果minuteDuration >= 60
      0 >= leap >= minuteDuration - 60                        如果minuteDuration <  60
 
```
    如果从secondInDayA + secondInDayB + leap计算得到的分钟秒数（getSecond()）大于或等于60 + leap，则分钟秒数将设置为FastMath.nextDown(60 + leap)。这样可以防止在输入值具有比double更高精度时将四舍五入到无效的分钟秒数。
    
    此构造函数始终处于UTC时间（即将返回0）。
    
    如果secondsInDayB或leap为NaN，则小时和分钟将根据secondInDayA确定，分钟秒数将为NaN。
    参数：
    
    secondInDayA - 秒数的第一部分。
    
    secondInDayB - 秒数的最后一部分。
    
    leap - 如果此时间点在闰秒期间，则为闰秒的大小，否则为0.0。此值不用于计算小时和分钟，但会添加到计算得到的分钟秒数中。
    
    minuteDuration - 当前分钟的秒数，通常为60。
    
    返回：
    
    指定时间的新时间组件。
    
    抛出：
    
    OrekitIllegalArgumentException - 如果上述不等式不成立。
    
    自：
    
    10.2
  - parseTime
```
public static TimeComponents parseTime(String string)
```
    解析ISO-8601格式的字符串以构建时间。
    支持的格式包括：
    - 基本和扩展格式的本地时间：hhmmss，hh:mm:ss（秒数可选小数部分）
    - 可选的UTC时间：hhmmssZ，hh:mm:ssZ
    - 可选的带符号小时UTC偏移量：hhmmss+HH，hhmmss-HH，hh:mm:ss+HH，hh:mm:ss-HH
    - 可选的带符号基本小时和分钟UTC偏移量：hhmmss+HHMM，hhmmss-HHMM，hh:mm:ss+HHMM，hh:mm:ss-HHMM
    - 可选的带符号扩展小时和分钟UTC偏移量：hhmmss+HH:MM，hhmmss-HH:MM，hh:mm:ss+HH:MM，hh:mm:ss-HH:MM
    如上列表所示，仅支持ISO-8601标准第4.2节中定义的完整表示，不支持扩展表示或精度降低的表示。
    参数:
    
    string - 要解析的字符串
    
    返回:
    
    解析后的时间
    
    抛出:
    
    IllegalArgumentException - 如果无法解析字符串
  - getHour
```
public int getHour()
```
    获取小时数。
    
    返回:
    
    从0到23的小时数
  - getMinute
```
public int getMinute()
```
    获取分钟数。
    
    返回:
    
    从0到59的分钟数
  - getSecond
```
public double getSecond()
```
    获取秒数。
    
    返回:
    
    从0.0到61.0（不包括）的秒数。请注意，60 ≤ 秒数 < 61 仅在闰秒时发生。
  - getMinutesFromUTC
```
public int getMinutesFromUTC()
```
    获取指定日期和UTC之间的偏移量。
    根据ISO-8601标准，偏移量始终是整数分钟。
    
    返回:
    
    指定日期和UTC之间的分钟偏移量
    
    自版本:
    
    7.2
  - getSecondsInLocalDay
```
public double getSecondsInLocalDay()
```
    获取当地日期内的秒数，不应用UTC偏移量。
    
    返回:
    
    从0.0到Constants.JULIAN_DAY的秒数
    
    自版本:
    
    7.2
    
    另请参阅:
    
    getSecondsInUTCDay()
  - getSecondsInUTCDay
```
public double getSecondsInUTCDay()
```
    获取UTC日期内的秒数，应用UTC偏移量。
    
    返回:
    
    从-getMinutesFromUTC()到Constants.JULIAN_DAY + getMinutesFromUTC()的秒数
    
    自版本:
    
    7.2
    
    另请参阅:
    
    getSecondsInLocalDay()
  - toStringWithoutUtcOffset
```
public String toStringWithoutUtcOffset()
```
    获取不包括UTC偏移量的时间的字符串表示。
    
    返回:
    
    以类似ISO 8601格式的字符串表示的时间。
    
    另请参阅:
    
    formatUtcOffset(), toString()
  - formatUtcOffset
```
public String formatUtcOffset()
```
    以ISO8601格式获取UTC偏移量的字符串。例如，+00:00。
    
    返回:
    
    作为字符串的UTC偏移量。
    
    另请参阅:
    
    toStringWithoutUtcOffset(), toString()
  - toString
```
public String toString()
```
    获取包括UTC偏移量的时间的字符串表示。
    
    覆盖:
    
    toString 在类 Object中
    
    返回:
    
    以包括UTC偏移量的ISO 8601格式表示的时间的字符串。
    
    另请参阅:
    
    toStringWithoutUtcOffset(), formatUtcOffset()
  - compareTo
```
public int compareTo(TimeComponents other)
```
    指定者:
    
    compareTo 在接口 Comparable<TimeComponents>中
  - equals
```
public boolean equals(Object other)
```
    覆盖:
    
    equals 在类 Object中
  - hashCode
```
public int hashCode()
```
    覆盖:
    
    hashCode 在类 Object中

Class TimeComponents

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

H00

H12

Constructor Detail

TimeComponents

TimeComponents

TimeComponents

TimeComponents

Method Detail

fromSeconds

parseTime

getHour

getMinute

getSecond

getMinutesFromUTC

getSecondsInLocalDay

getSecondsInUTCDay

toStringWithoutUtcOffset

formatUtcOffset

toString

compareTo

equals

hashCode