public class DateValue extends GDateValue implements java.lang.Comparable
day, daysPerMonth, month, monthData, xsd10rules, year
MISSING_TIMEZONE, NO_TIMEZONE
NaN_MATCH_KEY, typeLabel
Constructor and Description |
---|
DateValue(java.lang.CharSequence s)
Constructor: create a date value from a supplied string, in
ISO 8601 format
|
DateValue(java.lang.CharSequence s,
ConversionRules rules)
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,
boolean xsd10)
Constructor given a year, month, day and xsd10.
|
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.
|
DateValue(int year,
byte month,
byte day,
int tz,
boolean xsd10)
Constructor given a year, month, and day, and timezone.
|
Modifier and Type | Method and Description |
---|---|
DateValue |
add(DurationValue duration)
Add a duration to a date
|
DateValue |
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.
|
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)
|
int |
getJulianDayNumber()
Calculate the Julian day number at 00:00 on this date.
|
static int |
getJulianDayNumber(int year,
int month,
int day)
Calculate the Julian day number at 00:00 on a given date.
|
java.lang.CharSequence |
getPrimitiveStringValue()
Convert to string
|
BuiltInAtomicType |
getPrimitiveType()
Determine the primitive type of the value.
|
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,
ConversionRules rules)
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
|
checkValidInJavascript, compareTo, equals, getCalendar, getComponent, getDay, getMonth, getSchemaComparable, getYear, hashCode, isLeapYear, isValidDate, setLexicalValue, toDateTime
adjustTimezone, appendTimezone, appendTimezone, asMapKey, getComparisonKey, getTimezoneInMinutes, getXMLGregorianCalendar, getXPathComparable, hasTimezone, identityHashCode, isIdentical, makeCalendarValue, removeTimezone, setTimezoneInMinutes
asAtomic, atomize, checkPermittedContents, effectiveBooleanValue, getCardinality, getItemType, getStringValue, getStringValueCS, getUType, head, isIdentical, isNaN, itemAt, iterate, iterator, process, setTypeLabel, toString
getLength, isStreamed, reduce, subsequence
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
asAtomic
getLength
reduce, subsequence
public DateValue(int year, byte month, byte day)
year
- The year as held internally (note that the year before 1AD is supplied as 0,
but will be displayed on output as -0001)month
- The month, 1-12day
- The day, 1-31public DateValue(int year, byte month, byte day, boolean xsd10)
year
- The year as held internally (note that the year before 1AD is supplied as 0)month
- The month, 1-12day
- The day, 1-31xsd10
- Schema version flag. If set to true, the year before 1AD is displayed as -0001;
if false, it is displayed as 0000; but in both cases, it is held internally as zero. The flag
makes no difference to dates later than 1AD.public DateValue(int year, byte month, byte day, int tz, boolean xsd10)
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.xsd10
- Schema version flag. If set to true, the year before 1AD is displayed as -0001;
if false, it is displayed as 0000; but in both cases, it is held internally as zero. The flag
makes no difference to dates later than 1AD.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 value. Currently this assumes XSD 1.0
conventions for BC years (that is, no year zero), but this may change at some time.ValidationException
- if the supplied string is not a valid datepublic DateValue(java.lang.CharSequence s, ConversionRules rules) throws ValidationException
s
- the lexical form of the date valuerules
- the conversion rules (determining whether year zero is allowed)ValidationException
- 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, ConversionRules rules)
in
- the lexical form of the daterules
- conversion rules to apply (affects handling of year 0)public BuiltInAtomicType getPrimitiveType()
getPrimitiveType
in class 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 java.lang.CharSequence getPrimitiveStringValue()
getPrimitiveStringValue
in class AtomicValue
public java.lang.CharSequence getCanonicalLexicalRepresentation()
getCanonicalLexicalRepresentation
in interface AtomicSequence
getCanonicalLexicalRepresentation
in class AtomicValue
public AtomicValue copyAsSubType(AtomicType typeLabel)
copyAsSubType
in class AtomicValue
typeLabel
- the new type label: must be a subtype of xs:datepublic DateValue adjustTimezone(int timezone)
adjustTimezone
in class CalendarValue
timezone
- the new timezone offset, in minutespublic DateValue add(DurationValue duration) throws XPathException
add
in class 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
in class CalendarValue
other
- the other point in timecontext
- the XPath dynamic context. May be set to null
only if both values contain an explicit timezone, or if neither does so.XPathException
- for example if one value is a date and the other is a timepublic int compareTo(java.lang.Object v2)
compareTo
in interface 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 int getJulianDayNumber()
Note that this assumes dates in the proleptic Gregorian calendar
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)
See bug 21370 which clarified the specification. This caused a change to the Saxon implementation such that the days before the start of week 1 go in the last week of the previous month, not week zero.
year
- the yearmonth
- the month (1-12)day
- the day (1-31)Copyright (c) 2004-2018 Saxonica Limited. All rights reserved.