net.time4j.GeneralTimestamp Maven / Gradle / Ivy
/*
* -----------------------------------------------------------------------
* Copyright © 2013-2015 Meno Hochschild, Represents a general timestamp consisting of a general date and a 24-hour-clock time.
*
* Note: This class is only relevant for non-gregorian use-cases. Most users will use {@link PlainTimestamp}
* instead.
*
* @param generic type of date component
* @author Meno Hochschild
* @since 3.8/4.5
*/
/*[deutsch]
* Repräsentiert einen allgemeinen Zeitstempel, der aus einem allgemeinen Datum und einer 24-Stunden-Uhrzeit
* zusammengesetzt ist.
*
* Hinweis: Diese Klasse ist nur für nicht-gregorianische Anwendungsf&auuml;lle von Belang. Die meisten
* Anwender werden stattdessen {@link PlainTimestamp} nutzen.
*
* @param generic type of date component
* @author Meno Hochschild
* @since 3.8/4.5
*/
public final class GeneralTimestamp>
implements ChronoDisplay {
//~ Instanzvariablen --------------------------------------------------
private final CalendarVariant cv; // optional
private final Calendrical ca; // optional
private final PlainTime time;
//~ Konstruktoren -----------------------------------------------------
private GeneralTimestamp(
CalendarVariant cv,
Calendrical ca,
PlainTime time
) {
super();
if (time.getHour() == 24) { // NPE-check
if (cv == null) {
this.cv = null;
this.ca = ca.plus(CalendarDays.of(1));
} else {
this.cv = cv.plus(CalendarDays.of(1));
this.ca = null;
}
this.time = PlainTime.midnightAtStartOfDay();
} else {
this.cv = cv;
this.ca = ca;
this.time = time;
}
}
//~ Methoden ----------------------------------------------------------
/**
* Creates a new timestamp consisting of a calendar variant and a time component.
*
* @param generic type of date component
* @param calendarVariant date component
* @param time time component
* @return general timestamp
* @since 3.8/4.5
*/
/*[deutsch]
* Erzeugt einen neuen Zeitstempel, der aus einer Kalendervariante und einer Uhrzeitkomponente besteht.
*
* @param generic type of date component
* @param calendarVariant date component
* @param time time component
* @return general timestamp
* @since 3.8/4.5
*/
public static > GeneralTimestamp of(
C calendarVariant,
PlainTime time
) {
if (calendarVariant == null) {
throw new NullPointerException("Missing date component.");
}
return new GeneralTimestamp(calendarVariant, null, time);
}
/**
* Creates a new timestamp consisting of a general date and a time component.
*
* @param generic type of date component
* @param calendrical date component
* @param time time component
* @return general timestamp
* @since 3.8/4.5
*/
/*[deutsch]
* Erzeugt einen neuen Zeitstempel, der aus einem allgemeinen Datum und einer Uhrzeitkomponente besteht.
*
* @param generic type of date component
* @param calendrical date component
* @param time time component
* @return general timestamp
* @since 3.8/4.5
*/
public static > GeneralTimestamp of(
C calendrical,
PlainTime time
) {
if (calendrical == null) {
throw new NullPointerException("Missing date component.");
}
return new GeneralTimestamp(null, calendrical, time);
}
/**
* Yields the date component.
*
* @return date component
* @since 3.8/4.5
*/
/*[deutsch]
* Liefert die Datumskomponente.
*
* @return date component
* @since 3.8/4.5
*/
@SuppressWarnings("unchecked")
public C toDate() {
Object date = ((this.cv == null) ? this.ca : this.cv);
return (C) date;
}
/**
* Yields the time component.
*
* @return time component
* @since 3.8/4.5
*/
/*[deutsch]
* Liefert die Uhrzeitkomponente.
*
* @return time component
* @since 3.8/4.5
*/
public PlainTime toTime() {
return this.time;
}
@Override
public boolean equals(Object obj) {
if (this == obj) {
return true;
} else if (obj instanceof GeneralTimestamp) {
GeneralTimestamp that = GeneralTimestamp.class.cast(obj);
if (!this.time.equals(that.time)) {
return false;
} else if (this.cv == null) {
return ((that.cv == null) && this.ca.equals(that.ca));
} else {
return ((that.ca == null) && this.cv.equals(that.cv));
}
}
return false;
}
@Override
public int hashCode() {
int h = (
(this.cv == null)
? this.ca.hashCode()
: this.cv.hashCode());
return h + this.time.hashCode();
}
@Override
public String toString() {
StringBuilder sb = new StringBuilder();
if (this.cv == null) {
sb.append(this.ca);
} else {
sb.append(this.cv);
}
sb.append(this.time);
return sb.toString();
}
/**
* Combines this general timestamp with given timezone offset to a global UTC-moment.
*
* @param offset timezone offset
* @param startOfDay start of day
* @return global UTC-moment based on this general timestamp interpreted in given timezone
* @since 3.8/4.5
*/
/*[deutsch]
* Kombiniert diesen allgemeinen Zeitstempel mit dem angegebenen Zeitzonen-Offset zu einem UTC-Moment.
*
* @param offset timezone offset
* @param startOfDay start of day
* @return global UTC-moment based on this general timestamp interpreted in given timezone
* @since 3.8/4.5
*/
public Moment at(
ZonalOffset offset,
StartOfDay startOfDay
) {
PlainTimestamp tsp = (
(this.cv == null)
? this.ca.transform(PlainDate.class).at(this.time)
: this.cv.transform(PlainDate.class).at(this.time));
// assuming that deviation will not change much by one day difference (approximation)
int deviation = startOfDay.getDeviation(tsp.getCalendarDate(), offset);
int comp = this.time.get(PlainTime.SECOND_OF_DAY).intValue() - deviation;
if (comp >= 86400) { // happens if sunset is the start of day
tsp = tsp.minus(1, CalendarUnit.DAYS);
} else if (comp < 0) { // happens if sunrise is the start of day
tsp = tsp.plus(1, CalendarUnit.DAYS);
}
return tsp.at(offset);
}
/**
* Combines this general timestamp with given timezone to a global UTC-moment.
*
* @param tz timezone
* @param startOfDay start of day
* @return global UTC-moment based on this general timestamp interpreted in given timezone
* @since 3.8/4.5
*/
/*[deutsch]
* Kombiniert diesen allgemeinen Zeitstempel mit der angegebenen Zeitzone zu einem UTC-Moment.
*
* @param tz timezone
* @param startOfDay start of day
* @return global UTC-moment based on this general timestamp interpreted in given timezone
* @since 3.8/4.5
*/
public Moment in(
Timezone tz,
StartOfDay startOfDay
) {
PlainTimestamp tsp = (
(this.cv == null)
? this.ca.transform(PlainDate.class).at(this.time)
: this.cv.transform(PlainDate.class).at(this.time));
// assuming that deviation will not change much by one day difference (approximation)
int deviation = startOfDay.getDeviation(tsp.getCalendarDate(), tz.getID());
int comp = this.time.get(PlainTime.SECOND_OF_DAY).intValue() - deviation;
if (comp >= 86400) { // happens if sunset is the start of day
tsp = tsp.minus(1, CalendarUnit.DAYS);
} else if (comp < 0) { // happens if sunrise is the start of day
tsp = tsp.plus(1, CalendarUnit.DAYS);
}
return tsp.in(tz);
}
@Override
public boolean contains(ChronoElement element) {
return (element.isDateElement() ? this.toDate().contains(element) : this.time.contains(element));
}
@Override
public V get(ChronoElement element) {
return (element.isDateElement() ? this.toDate().get(element) : this.time.get(element));
}
@Override
public V getMinimum(ChronoElement element) {
return (element.isDateElement() ? this.toDate().getMinimum(element) : this.time.getMinimum(element));
}
@Override
public V getMaximum(ChronoElement element) {
return (element.isDateElement() ? this.toDate().getMaximum(element) : this.time.getMaximum(element));
}
@Override
public boolean hasTimezone() {
return false;
}
@Override
public TZID getTimezone() {
throw new ChronoException("Timezone not available: " + this);
}
} © 2015 - 2025 Weber Informatics LLC | Privacy Policy