org.opengis.cite.iso19142.util

Class TimeUtils

java.lang.Object

org.opengis.cite.iso19142.util.TimeUtils

public class TimeUtils
extends Object

Provides various utility methods for working with representations of temporal values.

Constructor Summary

Constructors

Constructor and Description
TimeUtils()

Method Summary

Modifier and Type	Method and Description
static Document	instantAsGML(org.opengis.temporal.Instant instant, ZoneOffset offset) Builds a GML representation of a time instant with the specified time-zone offset.
static Document	intervalAsGML(ZonedDateTime startDateTime, ZonedDateTime endDateTime) Builds a GML representation of a time interval delimited by the given time instants.
static Document	periodAsGML(org.opengis.temporal.Period period) Builds a GML representation of the given time period.

Methods inherited from class java.lang.Object

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

Constructor Detail

TimeUtils

public TimeUtils()

Method Detail

intervalAsGML

public static Document intervalAsGML(ZonedDateTime startDateTime,
                                     ZonedDateTime endDateTime)

Builds a GML representation of a time interval delimited by the given time instants. The temporal reference system is ISO 8601 (UTC).

Parameters:

startDateTime - The starting instant.

endDateTime - The ending instant.

Returns:

A Document with gml:TimePeriod as the document element, or null if it cannot be created.

periodAsGML

public static Document periodAsGML(org.opengis.temporal.Period period)

Builds a GML representation of the given time period.

Parameters:

period - A Period representing a temporal interval (UTC).

Returns:

A Document with gml:TimePeriod as the document element.

instantAsGML

public static Document instantAsGML(org.opengis.temporal.Instant instant,
                                    ZoneOffset offset)

Builds a GML representation of a time instant with the specified time-zone offset.

Parameters:

instant - An instant representing a position in time.

offset - A time-zone offset from UTC ('Z' if null).

Returns:

A Document with gml:TimeInstant as the document element.