Overview

This class represents a flexible timing structure. It is flexible in that it can be used to represent times of varying granularity.

If a time is floating, it means that it represents the same time no matter what timezone (e.g., lunch is always at noon regardless of timezone). If no timezone is specified, then it is assumed to be UTC.

Since this class acts to hold time, it is an immutable object.

The following table explains how the time is interpreted based on the dateOnly and floatingTime settings (what is significant):
dateOnly/floatingTime true false
true Ignored Date in a timezone
false Date and floating time Date and time in a timezone

Members

Name Type Required Description

dateOnly

boolean

Return true if the DateTime represent a date (not a specific time in a day).

floatingTime

boolean

Return true if the DateTime is not bound to a specific timezone.

scheduledTimeZone

timeZone

Return the TimeZone associated with the datetime.

timestamp

dateTime

Return the timestamp attribute.

timestampTime

long

Return the timestamp attribute in the milliseconds time value. Similar to getTimestamp().getTime() but more efficient.

Hierarchy

Examples

Below are examples in XML formats. All examples are shown with all inherited members. Quoting when required is part of the examples, but you must obviously populate with your own data.

XML Example

(show inherited members)

<obh:dateTime xsi:type="obh:dateTime" xmlns:obh="http://www.oracle.com/beehive" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <dateOnly>your_boolean_0</dateOnly>
        <floatingTime>your_boolean_0</floatingTime>
        <scheduledTimeZone>your_timeZone_0</scheduledTimeZone>
        <timestamp>your_dateTime_0</timestamp>
        <timestampTime>your_long_0</timestampTime>
</obh:dateTime>

Referenced By Representaions