Package org.jruby.ext.date

Class RubyDateTime

java.lang.Object

org.jruby.RubyBasicObject

org.jruby.RubyObject

org.jruby.ext.date.RubyDate

org.jruby.ext.date.RubyDateTime

All Implemented Interfaces:

Serializable, Cloneable, Comparable<IRubyObject>, InstanceVariables, InternalVariables, IRubyObject, CoreObjectType

public class RubyDateTime
extends RubyDate

JRuby's DateTime implementation - 'native' parts. In MRI, since 2.x, all of date.rb has been moved to native (C) code. NOTE: There's still date.rb, where this gets bootstrapped from.

Since:

9.2

See Also:

• RubyDate
• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.jruby.RubyObject

RubyObject.Data

Nested classes/interfaces inherited from class org.jruby.RubyBasicObject

RubyBasicObject.Finalizer

Field Summary

Fields

Modifier and Type	Field	Description
private static final String	DEFAULT_FORMAT
private static final ByteList	STRF_FORMAT_BYTES
private static final ByteList	TO_S_FORMAT

Fields inherited from class org.jruby.ext.date.RubyDate

CHRONO_ITALY_UTC, DAY_IN_SECONDS, DAY_MS, defaultDateTime, dt, ENGLAND, GREGORIAN, ITALY, JULIAN, LOG, off, REFORM_BEGIN_YEAR, REFORM_END_YEAR, start, SUB_MS_PRECISION, subMillisDen, subMillisNum

Fields inherited from class org.jruby.RubyObject

IVAR_INSPECTING_OBJECT_ALLOCATOR, OBJECT_ALLOCATOR, REIFYING_OBJECT_ALLOCATOR

Fields inherited from class org.jruby.RubyBasicObject

ALL_F, BASICOBJECT_ALLOCATOR, COMPARE_BY_IDENTITY_F, ERR_INSECURE_SET_INST_VAR, FALSE_F, FL_USHIFT, flags, FROZEN_F, IS_OVERLAID_F, metaClass, NEVER, NIL_F, REFINED_MODULE_F, STAMP_OFFSET, TAINTED_F, UNDEF, UNTRUST_F, USER0_F, USER1_F, USER2_F, USER3_F, USER4_F, USER5_F, USER6_F, USER7_F, USER8_F, USER9_F, USERA_F, VAR_TABLE_OFFSET, varTable, varTableStamp

Fields inherited from interface org.jruby.runtime.builtin.IRubyObject

NULL_ARRAY

Constructor Summary

Constructors

Modifier	Constructor	Description
	RubyDateTime(Ruby runtime, long millis, org.joda.time.Chronology chronology)
	RubyDateTime(Ruby runtime, org.joda.time.DateTime dt)
protected	RubyDateTime(Ruby runtime, RubyClass klass)
	RubyDateTime(Ruby runtime, RubyClass klass, org.joda.time.DateTime dt)
private	RubyDateTime(Ruby runtime, RubyClass klass, org.joda.time.DateTime dt, int off)
(package private)	RubyDateTime(Ruby runtime, RubyClass klass, org.joda.time.DateTime dt, int off, long start)
(package private)	RubyDateTime(Ruby runtime, RubyClass klass, org.joda.time.DateTime dt, int off, long start, long subMillisNum, long subMillisDen)
(package private)	RubyDateTime(ThreadContext context, RubyClass klass, IRubyObject ajd, int off, long start)
private	RubyDateTime(ThreadContext context, RubyClass klass, IRubyObject ajd, long[] rest, int off, long start)
(package private)	RubyDateTime(ThreadContext context, RubyClass klass, IRubyObject ajd, org.joda.time.Chronology chronology, int off)

Method Summary

Modifier and Type	Method	Description
static IRubyObject	_strptime(ThreadContext context, IRubyObject self, IRubyObject string)
static IRubyObject	_strptime(ThreadContext context, IRubyObject self, IRubyObject string, IRubyObject format)
private static void	addFraction(ThreadContext context, long[] rest, RubyNumeric fr, boolean roundFloat)
private static void	addRationalModToRest(ThreadContext context, RubyRational rat, long ival, long[] rest)
private static void	addRationalModToRest(ThreadContext context, IRubyObject val, long ival, long[] rest)
private static void	assertValidFraction(ThreadContext context, IRubyObject val, long ival)
private static void	calcBigIntDayRest(RubyRational day, long d, long[] rest)
static RubyDateTime	civil(ThreadContext context, IRubyObject self)	# Create a new DateTime object corresponding to the specified # Civil Date and hour +h+, minute +min+, second +s+.
static RubyDateTime	civil(ThreadContext context, IRubyObject self, IRubyObject year)
static RubyDateTime	civil(ThreadContext context, IRubyObject self, IRubyObject[] args)
static RubyDateTime	civil(ThreadContext context, IRubyObject self, IRubyObject year, IRubyObject month)
(package private) static RubyClass	createDateTimeClass(Ruby runtime, RubyClass Date)
(package private) static long	getDay(ThreadContext context, IRubyObject day, long[] rest)
(package private) static int	getHour(ThreadContext context, IRubyObject hour, long[] rest)
(package private) static int	getMinute(ThreadContext context, IRubyObject val, long[] rest)
(package private) static int	getSecond(ThreadContext context, IRubyObject val, long[] rest)
static RubyDateTime	jd(ThreadContext context, IRubyObject self)	# Create a new DateTime object corresponding to the specified # Julian Day Number +jd+ and hour +h+, minute +min+, second +s+.
static RubyDateTime	jd(ThreadContext context, IRubyObject self, IRubyObject[] args)
(package private) RubyDate	newInstance(ThreadContext context, org.joda.time.DateTime dt, int off, long start, long subNum, long subDen)
IRubyObject	next_day(ThreadContext context, IRubyObject n)
static RubyDateTime	now(ThreadContext context, IRubyObject self)	# Create a new DateTime object representing the current time.
static RubyDateTime	now(ThreadContext context, IRubyObject self, IRubyObject sg)
IRubyObject	prev_day(ThreadContext context, IRubyObject n)
private RubyDate	prevNextDay(ThreadContext context, IRubyObject n, boolean negate)
RubyString	strftime(ThreadContext context)
RubyString	strftime(ThreadContext context, IRubyObject fmt)
RubyDate	to_date(ThreadContext context)
RubyDateTime	to_datetime()
RubyString	to_s(ThreadContext context)
RubyTime	to_time(ThreadContext context)
<T> T	toJava(Class<T> target)	Convert the object to the specified Java class, if possible.
LocalDateTime	toLocalDateTime()
OffsetDateTime	toOffsetDateTime()
ZonedDateTime	toZonedDateTime()
(package private) static org.joda.time.DateTime	withTimeAt0InZone(org.joda.time.DateTime dt, org.joda.time.DateTimeZone zone)

Methods inherited from class org.jruby.ext.date.RubyDate

_comp_year69, _i, _load, _match, _parse_day, _parse_ddd, _parse_dot, _parse_eu, _parse_impl, _parse_iso, _parse_iso2, _parse_jis, _parse_mday, _parse_mon, _parse_sla, _parse_time, _parse_us, _parse_vms, _parse_year, _s3e, _strptime, _subs, _valid_civil_p, _valid_civil_p, _valid_commercial_p, _valid_jd_p, _valid_jd_p, _valid_ordinal_p, _valid_ordinal_p, _valid_time_p, _valid_weeknum_p, adjustJodaYear, ajd, amjd, civil, civilDate, civilImpl, civilImpl, commercial, createDateClass, cwday, cweek, cwyear, day_fraction, debug, england, eql_p, equals, equals, format, getChronology, getChronology, getDate, getDateTime, getDateTime, getDay, getHour, getJavaClass, getJulianDayNumber, getMinute, getMonth, getMonth, getNanos, getSecond, getValidStart, getYear, getYear, gregorian, gregorian_leap_p, gregorian_p, hash, hash, hashCode, hour, initialize, initialize, initialize, initialize_copy, inspect, inspect, isJulian, italy, jd, jd, jd, jd_to_ajd, jd_to_ajd, jd_to_ajd, jd_to_ajd, julian, julian_leap_p, julian_p, ld, leap_p, marshal_dump, marshal_load, mday, minute, mjd, mon, new_, new_, new_, new_, new_offset, new_start, new_start, newInstance, newRationalConvert, next, next_day, next_month, next_month, next_year, next_year, normalizeSubMillis, offset, op_cmp, op_eqq, op_minus, op_plus, op_plus_numeric, ordinal, parse, parse_bc, parse_frag, prev_day, prev_month, prev_month, prev_year, prev_year, roundToPrecision, sec_fraction, second, shift_bw, shift_fw, start, subMillis, timesIntDiff, timeToDayFraction, to_date, to_datetime, to_s, toDate, today, today, toInstant, toLocalDate, val2off, val2sg, valid_civil_p, valid_commercial_p, valid_jd_p, valid_jd_p, valid_ordinal_p, valid_sg, validCivilImpl, validCommercialImpl, validOrdinalImpl, wday, yday, year, zone, zone_to_diff

Methods inherited from class org.jruby.RubyObject

attachToObjectSpace, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, convertToType, createObjectClass, dig, dig1, dig2, eqlInternal, equalInternal, getNativeClassIndex, inspect, puts, specificEval, toRubyString, toString

Methods inherited from class org.jruby.RubyBasicObject

addFinalizer, anyToString, asJavaString, asString, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callSuper, checkArrayType, checkCallMethod, checkCallMethod, checkFrozen, checkStringType, checkStringType19, compareTo, convertToArray, convertToFloat, convertToHash, convertToInteger, convertToInteger, convertToInteger, convertToString, copyInstanceVariablesInto, copySpecialInstanceVariables, createBasicObjectClass, dataGetStruct, dataGetStructChecked, dataWrapStruct, decode, display, dup, ensureInstanceVariablesSettable, eql, equal_p, equal_p19, evalUnder, extend, fastGetInstanceVariable, fastGetInternalVariable, fastHasInstanceVariable, fastHasInternalVariable, fastSetInstanceVariable, fastSetInternalVariable, freeze, frozen_p, getFFIHandle, getFlag, getInstanceEvalClass, getInstanceVariable, getInstanceVariableList, getInstanceVariableNameList, getInstanceVariables, getInternalVariable, getInternalVariables, getMetaClass, getMetaClass, getNativeHandle, getNativeTypeIndex, getObjectId, getRuntime, getSingletonClass, getSingletonClassClone, getSingletonClassCloneAndAttach, getType, getVariable, getVariableCount, getVariableList, getVariableNameList, hashyInspect, hasInstanceVariable, hasInstanceVariables, hasInternalVariable, hasVariables, id, infectBy, initialize, initialize19, inspectHashCode, instance_eval, instance_eval, instance_eval, instance_eval, instance_eval19, instance_eval19, instance_eval19, instance_eval19, instance_exec, instance_exec19, instance_of_p, instance_variable_defined_p, instance_variable_get, instance_variable_set, instance_variables, instance_variables19, isBuiltin, isClass, isFalse, isFrozen, isImmediate, isModule, isNil, isSpecialConst, isSpecialObject, isTaint, isTrue, isUntrusted, kind_of_p, makeMetaClass, method, method_missing, method_missing19, method19, methods, methods, methods19, nil_p, nonFixnumHashCode, OBJ_INIT_COPY, objInitCopy, op_equal, op_equal_19, op_match, op_match19, op_not, op_not_equal, op_not_match, private_methods, private_methods19, protected_methods, protected_methods19, public_methods, public_methods19, rbClone, rbClone, rbInspect, remove_instance_variable, removeFinalizers, removeInstanceVariable, removeInternalVariable, respond_to_p, respond_to_p, respond_to_p19, respond_to_p19, respondsTo, respondsToMissing, respondsToMissing, send, send, send, send, send, send19, send19, send19, send19, setFFIHandle, setFlag, setFrozen, setInstanceVariable, setInternalVariable, setMetaClass, setNativeHandle, setTaint, setUntrusted, setVariable, singleton_method, singleton_method_added, singleton_method_added19, singleton_method_removed, singleton_method_removed19, singleton_method_undefined, singleton_method_undefined19, singleton_methods, specificEval, specificEval, specificEval, specificEval, syncVariables, syncVariables, taint, taint, tainted_p, testFrozen, testFrozen, to_a, to_a, trust, type, type_deprecated, untaint, untrust, untrusted_p, validateInstanceVariable, validateInstanceVariable, validateInstanceVariable, variableTableContains, variableTableFastContains, variableTableFastFetch, variableTableFastStore, variableTableFetch, variableTableRemove, variableTableStore, variableTableSync, yieldUnder, yieldUnder

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

TO_S_FORMAT

private static final ByteList TO_S_FORMAT

STRF_FORMAT_BYTES

private static final ByteList STRF_FORMAT_BYTES

DEFAULT_FORMAT

private static final String DEFAULT_FORMAT

See Also:

• Constant Field Values

Constructor Details

RubyDateTime

protected RubyDateTime(Ruby runtime,
 RubyClass klass)

RubyDateTime

public RubyDateTime(Ruby runtime,
 RubyClass klass,
 org.joda.time.DateTime dt)

RubyDateTime

public RubyDateTime(Ruby runtime,
 org.joda.time.DateTime dt)

RubyDateTime

public RubyDateTime(Ruby runtime,
 long millis,
 org.joda.time.Chronology chronology)

RubyDateTime

RubyDateTime(ThreadContext context,
 RubyClass klass,
 IRubyObject ajd,
 int off,
 long start)

RubyDateTime

private RubyDateTime(ThreadContext context,
 RubyClass klass,
 IRubyObject ajd,
 long[] rest,
 int off,
 long start)

RubyDateTime

private RubyDateTime(Ruby runtime,
 RubyClass klass,
 org.joda.time.DateTime dt,
 int off)

RubyDateTime

RubyDateTime(Ruby runtime,
 RubyClass klass,
 org.joda.time.DateTime dt,
 int off,
 long start)

RubyDateTime

RubyDateTime(Ruby runtime,
 RubyClass klass,
 org.joda.time.DateTime dt,
 int off,
 long start,
 long subMillisNum,
 long subMillisDen)

RubyDateTime

RubyDateTime(ThreadContext context,
 RubyClass klass,
 IRubyObject ajd,
 org.joda.time.Chronology chronology,
 int off)

Method Details

createDateTimeClass

static RubyClass createDateTimeClass(Ruby runtime,
 RubyClass Date)

newInstance

RubyDate newInstance(ThreadContext context,
 org.joda.time.DateTime dt,
 int off,
 long start,
 long subNum,
 long subDen)

Overrides:

newInstance in class RubyDate

civil

public static RubyDateTime civil(ThreadContext context,
 IRubyObject self)

# Create a new DateTime object corresponding to the specified # Civil Date and hour +h+, minute +min+, second +s+. # # The 24-hour clock is used. Negative values of +h+, +min+, and # +sec+ are treating as counting backwards from the end of the # next larger unit (e.g. a +min+ of -2 is treated as 58). No # wraparound is performed. If an invalid time portion is specified, # an ArgumentError is raised. # # +of+ is the offset from UTC as a fraction of a day (defaults to 0). # +sg+ specifies the Day of Calendar Reform. # # +y+ defaults to -4712, +m+ to 1, and +d+ to 1; this is Julian Day # Number day 0. The time values default to 0.

civil

public static RubyDateTime civil(ThreadContext context,
 IRubyObject self,
 IRubyObject year)

civil

public static RubyDateTime civil(ThreadContext context,
 IRubyObject self,
 IRubyObject year,
 IRubyObject month)

civil

public static RubyDateTime civil(ThreadContext context,
 IRubyObject self,
 IRubyObject[] args)

getDay

static long getDay(ThreadContext context,
 IRubyObject day,
 long[] rest)

calcBigIntDayRest

private static void calcBigIntDayRest(RubyRational day,
 long d,
 long[] rest)

getHour

static int getHour(ThreadContext context,
 IRubyObject hour,
 long[] rest)

getMinute

static int getMinute(ThreadContext context,
 IRubyObject val,
 long[] rest)

getSecond

static int getSecond(ThreadContext context,
 IRubyObject val,
 long[] rest)

addRationalModToRest

private static void addRationalModToRest(ThreadContext context,
 IRubyObject val,
 long ival,
 long[] rest)

addRationalModToRest

private static void addRationalModToRest(ThreadContext context,
 RubyRational rat,
 long ival,
 long[] rest)

addFraction

private static void addFraction(ThreadContext context,
 long[] rest,
 RubyNumeric fr,
 boolean roundFloat)

assertValidFraction

private static void assertValidFraction(ThreadContext context,
 IRubyObject val,
 long ival)

jd

public static RubyDateTime jd(ThreadContext context,
 IRubyObject self)

# Create a new DateTime object corresponding to the specified # Julian Day Number +jd+ and hour +h+, minute +min+, second +s+. # # The 24-hour clock is used. Negative values of +h+, +min+, and # +sec+ are treating as counting backwards from the end of the # next larger unit (e.g. a +min+ of -2 is treated as 58). No # wraparound is performed. If an invalid time portion is specified, # an ArgumentError is raised. # # +of+ is the offset from UTC as a fraction of a day (defaults to 0). # +sg+ specifies the Day of Calendar Reform. # # All day/time values default to 0.

jd

public static RubyDateTime jd(ThreadContext context,
 IRubyObject self,
 IRubyObject[] args)

now

public static RubyDateTime now(ThreadContext context,
 IRubyObject self)

# Create a new DateTime object representing the current time. # # +sg+ specifies the Day of Calendar Reform.

now

public static RubyDateTime now(ThreadContext context,
 IRubyObject self,
 IRubyObject sg)

prev_day

public IRubyObject prev_day(ThreadContext context,
 IRubyObject n)

Overrides:

prev_day in class RubyDate

next_day

public IRubyObject next_day(ThreadContext context,
 IRubyObject n)

Overrides:

next_day in class RubyDate

prevNextDay

private RubyDate prevNextDay(ThreadContext context,
 IRubyObject n,
 boolean negate)

to_s

public RubyString to_s(ThreadContext context)

Overrides:

to_s in class RubyDate

to_date

public RubyDate to_date(ThreadContext context)

withTimeAt0InZone

static org.joda.time.DateTime withTimeAt0InZone(org.joda.time.DateTime dt,
 org.joda.time.DateTimeZone zone)

to_datetime

public RubyDateTime to_datetime()

to_time

public RubyTime to_time(ThreadContext context)

Overrides:

to_time in class RubyDate

strftime

public RubyString strftime(ThreadContext context)

Overrides:

strftime in class RubyDate

strftime

public RubyString strftime(ThreadContext context,
 IRubyObject fmt)

Overrides:

strftime in class RubyDate

_strptime

public static IRubyObject _strptime(ThreadContext context,
 IRubyObject self,
 IRubyObject string)

_strptime

public static IRubyObject _strptime(ThreadContext context,
 IRubyObject self,
 IRubyObject string,
 IRubyObject format)

toLocalDateTime

public LocalDateTime toLocalDateTime()

Returns:

a date time

toZonedDateTime

public ZonedDateTime toZonedDateTime()

Returns:

a date time

toOffsetDateTime

public OffsetDateTime toOffsetDateTime()

Returns:

a date time

toJava

public <T> T toJava(Class<T> target)

Description copied from interface: IRubyObject

Convert the object to the specified Java class, if possible.

Specified by:

toJava in interface IRubyObject

Overrides:

toJava in class RubyDate

Parameters:

target - The target type to which the object should be converted.

See Also:

• IRubyObject.toJava(java.lang.Class<T>)