Class DateTimeValue


  • public class DateTimeValue
    extends java.lang.Object
    This class represents a date or time value as it is represented in the database. In contrast to java.sql.Date, java.sql.Time and java.sql.Timestamp, which are based on java.util.Date, this class does not represent the time as an offset from midnight, January 1, 1970 GMT. Instead, it holds each component (year, month, day, hour, minute, second, nanosecond) as it would have been represented in a given calendar. Since it does not hold information about the time zone for the time it represents, it does not point to a well-defined point in time without being used together with a java.util.Calendar object.
    • Field Summary

      Fields 
      Modifier and Type Field Description
      private int day  
      private int hours  
      private int minutes  
      private int month  
      private int nanos  
      private int seconds  
      private int year  
    • Constructor Summary

      Constructors 
      Modifier Constructor Description
        DateTimeValue​(java.sql.Date date)
      Create an instance from a java.sql.Date using the default calendar.
      (package private) DateTimeValue​(java.sql.Date date, java.util.Calendar cal)
      Create an instance from a java.sql.Timestamp using the specified java.util.Calendar.
        DateTimeValue​(java.sql.Time time)
      Create an instance from a java.sql.Time using the default calendar.
      (package private) DateTimeValue​(java.sql.Time time, java.util.Calendar cal)
      Create an instance from a java.sql.Time using the specified java.util.Calendar.
        DateTimeValue​(java.sql.Timestamp ts)
      Create an instance from a java.sql.Timestamp using the default calendar.
      (package private) DateTimeValue​(java.sql.Timestamp ts, java.util.Calendar cal)
      Create an instance from a java.sql.Timestamp using the specified java.util.Calendar.
      private DateTimeValue​(java.util.Calendar cal, int nanoFraction)
      Construct a DateTimeValue from a java.util.Calendar.
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      int getDayOfMonth()
      Get day of month component.
      int getHours()
      Get hour of day component (24 hour clock).
      int getMinutes()
      Get minute component.
      int getMonth()
      Get the month component.
      int getNanos()
      Get nanosecond component.
      int getSeconds()
      Get second component.
      int getYear()
      Get the year component.
      private static java.util.Calendar initCalendar​(java.util.Calendar cal, java.util.Date date)
      Set the time of a calendar.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • year

        private final int year
      • month

        private final int month
      • day

        private final int day
      • hours

        private final int hours
      • minutes

        private final int minutes
      • seconds

        private final int seconds
      • nanos

        private final int nanos
    • Constructor Detail

      • DateTimeValue

        private DateTimeValue​(java.util.Calendar cal,
                              int nanoFraction)
        Construct a DateTimeValue from a java.util.Calendar.
        Parameters:
        cal - the calendar from which to get the values of the fields
        nanoFraction - the nano second fraction of a second (the milliseconds will be taken from cal, so only the six least significant digits of this value are used)
      • DateTimeValue

        DateTimeValue​(java.sql.Date date,
                      java.util.Calendar cal)
        Create an instance from a java.sql.Timestamp using the specified java.util.Calendar.
      • DateTimeValue

        DateTimeValue​(java.sql.Time time,
                      java.util.Calendar cal)
        Create an instance from a java.sql.Time using the specified java.util.Calendar.
      • DateTimeValue

        DateTimeValue​(java.sql.Timestamp ts,
                      java.util.Calendar cal)
        Create an instance from a java.sql.Timestamp using the specified java.util.Calendar.
      • DateTimeValue

        public DateTimeValue​(java.sql.Date date)
        Create an instance from a java.sql.Date using the default calendar.
      • DateTimeValue

        public DateTimeValue​(java.sql.Time time)
        Create an instance from a java.sql.Time using the default calendar.
      • DateTimeValue

        public DateTimeValue​(java.sql.Timestamp ts)
        Create an instance from a java.sql.Timestamp using the default calendar.
    • Method Detail

      • initCalendar

        private static java.util.Calendar initCalendar​(java.util.Calendar cal,
                                                       java.util.Date date)
        Set the time of a calendar.
        Parameters:
        cal - the calendar
        date - an object representing the new time of the calendar
        Returns:
        the calendar (same as cal)
      • getYear

        public int getYear()
        Get the year component.
      • getMonth

        public int getMonth()
        Get the month component. First month is 0 (Calendar.JANUARY).
      • getDayOfMonth

        public int getDayOfMonth()
        Get day of month component. First day of the month is 1.
      • getHours

        public int getHours()
        Get hour of day component (24 hour clock).
      • getMinutes

        public int getMinutes()
        Get minute component.
      • getSeconds

        public int getSeconds()
        Get second component.
      • getNanos

        public int getNanos()
        Get nanosecond component.