public class DateValue extends GDateValue implements java.lang.Comparable
day, daysPerMonth, month, monthData, year
NO_TIMEZONE
typeLabel
EMPTY_CLASS_ARRAY, INDETERMINATE_ORDERING
EMPTY_VALUE_ARRAY
?????? |
---|
DateValue(java.lang.CharSequence s)
Constructor: create a date value from a supplied string, in
ISO 8601 format
|
DateValue(java.util.GregorianCalendar calendar,
int tz)
Create a DateValue
|
DateValue(int year,
byte month,
byte day)
Constructor given a year, month, and day.
|
DateValue(int year,
byte month,
byte day,
int tz)
Constructor given a year, month, and day, and timezone.
|
DateValue(int year,
byte month,
byte day,
int tz,
AtomicType type)
Constructor given a year, month, and day, and timezone, and an AtomicType representing
a subtype of xs:date.
|
?????? | ????? |
---|---|
CalendarValue |
add(DurationValue duration)
Add a duration to a date
|
CalendarValue |
adjustTimezone(int timezone)
Return a new date with the same normalized value, but
in a different timezone.
|
int |
compareTo(java.lang.Object v2)
Context-free comparison of two DateValue values.
|
ConversionResult |
convertPrimitive(BuiltInAtomicType requiredType,
boolean validate,
XPathContext context)
Convert to target data type
|
AtomicValue |
copyAsSubType(AtomicType typeLabel)
Make a copy of this date value, but with a new type label
|
static DateValue |
dateFromJulianDayNumber(int julianDayNumber)
Get the Gregorian date corresponding to a particular Julian day number.
|
java.lang.CharSequence |
getCanonicalLexicalRepresentation()
Get the canonical lexical representation as defined in XML Schema.
|
static int |
getDayOfWeek(int year,
int month,
int day)
Get the day of the week.
|
static int |
getDayWithinYear(int year,
int month,
int day)
Get the ordinal day number within the year (1 Jan = 1, 1 Feb = 32, etc)
|
static int |
getJulianDayNumber(int year,
int month,
int day)
Calculate the Julian day number at 00:00 on a given date.
|
BuiltInAtomicType |
getPrimitiveType()
Determine the primitive type of the value.
|
java.lang.CharSequence |
getStringValueCS()
Convert to string
|
static int |
getWeekNumber(int year,
int month,
int day)
Get the ISO week number for a given date.
|
static int |
getWeekNumberWithinMonth(int year,
int month,
int day)
Get the week number within a month.
|
static ConversionResult |
makeDateValue(java.lang.CharSequence in)
Static factory method: construct a DateValue from a string in the lexical form
of a date, returning a ValidationFailure if the supplied string is invalid
|
DayTimeDurationValue |
subtract(CalendarValue other,
XPathContext context)
Determine the difference between two points in time, as a duration
|
static DateValue |
tomorrow(int year,
byte month,
byte day)
Get the date that immediately follows a given date
|
static DateValue |
yesterday(int year,
byte month,
byte day)
Get the date that immediately precedes a given date
|
compareTo, equals, getCalendar, getComparisonKey, getComponent, getDay, getMonth, getSchemaComparable, getYear, hashCode, isLeapYear, isValidDate, setLexicalValue, toDateTime
adjustTimezone, appendTimezone, appendTimezone, getStringValue, getTimezoneInMinutes, getXPathComparable, hasTimezone, removeTimezone, setTimezoneInMinutes
asAtomic, checkPermittedContents, convert, convert, effectiveBooleanValue, getCardinality, getItemType, getLength, getTypedValue, getTypeLabel, isNaN, itemAt, iterate, process, setTypeLabel, subsequence, toString
asItem, asItem, asIterator, asValue, convertToJava, fromItem, getIterator, iterate, makeQNameValue, reduce, stringToNumber
public DateValue(int year, byte month, byte day)
year
- The year as held internally (note that the year before 1AD is 0)month
- The month, 1-12day
- The day 1-31public DateValue(int year, byte month, byte day, int tz)
year
- The year as held internally (note that the year before 1AD is 0)month
- The month, 1-12day
- The day 1-31tz
- the timezone displacement in minutes from UTC. Supply the value
CalendarValue.NO_TIMEZONE
if there is no timezone component.public DateValue(int year, byte month, byte day, int tz, AtomicType type)
year
- The year as held internally (note that the year before 1AD is 0)month
- The month, 1-12day
- The day 1-31tz
- the timezone displacement in minutes from UTC. Supply the value
CalendarValue.NO_TIMEZONE
if there is no timezone component.type
- the type. This must be a type derived from xs:date, and the value
must conform to this type. The method does not check these conditions.public DateValue(java.lang.CharSequence s) throws ValidationException
s
- the lexical form of the date valueValidationException
- if the supplied string is not a valid datepublic DateValue(java.util.GregorianCalendar calendar, int tz)
calendar
- the absolute date/time valuetz
- The timezone offset from GMT in minutes, positive or negative; or the special
value NO_TIMEZONE indicating that the value is not in a timezonepublic static ConversionResult makeDateValue(java.lang.CharSequence in)
in
- the lexical form of the datepublic BuiltInAtomicType getPrimitiveType()
getPrimitiveType
??? AtomicValue
public static DateValue tomorrow(int year, byte month, byte day)
year
- the yearmonth
- the month (1-12)day
- the day (1-31)public static DateValue yesterday(int year, byte month, byte day)
year
- the yearmonth
- the month (1-12)day
- the day (1-31)public ConversionResult convertPrimitive(BuiltInAtomicType requiredType, boolean validate, XPathContext context)
convertPrimitive
??? AtomicValue
requiredType
- an integer identifying the required atomic typecontext
- the XPath dynamic contextvalidate
- true if validation is required. If set to false, the caller guarantees that
the value is valid for the target data type, and that further validation
is therefore not required.
Note that a validation failure may be reported even if validation was not requested.public java.lang.CharSequence getStringValueCS()
getStringValueCS
???? Item
getStringValueCS
???? ValueRepresentation
getStringValueCS
??? AtomicValue
Item.getStringValue()
public java.lang.CharSequence getCanonicalLexicalRepresentation()
getCanonicalLexicalRepresentation
??? Value
public AtomicValue copyAsSubType(AtomicType typeLabel)
copyAsSubType
??? AtomicValue
typeLabel
- the new type label: must be a subtype of xs:datepublic CalendarValue adjustTimezone(int timezone)
adjustTimezone
??? CalendarValue
timezone
- the new timezone offset, in minutespublic CalendarValue add(DurationValue duration) throws XPathException
add
??? CalendarValue
duration
- the duration to be added (may be negative)XPathException
- if the duration is an xs:duration, as distinct from
a subclass thereofpublic DayTimeDurationValue subtract(CalendarValue other, XPathContext context) throws XPathException
subtract
??? CalendarValue
other
- the other point in timecontext
- the XPath dynamic contextXPathException
- for example if one value is a date and the other is a timepublic int compareTo(java.lang.Object v2)
compareTo
???? java.lang.Comparable
v2
- the other valuejava.lang.ClassCastException
- if the values are not comparable (which might be because
no timezone is available)public static int getJulianDayNumber(int year, int month, int day)
Note that this assumes dates in the proleptic Gregorian calendar
year
- the yearmonth
- the month (1-12)day
- the day (1-31)public static DateValue dateFromJulianDayNumber(int julianDayNumber)
julianDayNumber
- the Julian day numberpublic static int getDayWithinYear(int year, int month, int day)
year
- the yearmonth
- the month (1-12)day
- the day (1-31)public static int getDayOfWeek(int year, int month, int day)
year
- the yearmonth
- the month (1-12)day
- the day (1-31)public static int getWeekNumber(int year, int month, int day)
year
- the yearmonth
- the month (1-12)day
- the day (1-31)public static int getWeekNumberWithinMonth(int year, int month, int day)
year
- the yearmonth
- the month (1-12)day
- the day (1-31)