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

Author:

kares

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 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, 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)	Deprecated.
protected	RubyDateTime(Ruby runtime, RubyClass klass)
	RubyDateTime(Ruby runtime, RubyClass klass, org.joda.time.DateTime dt)

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)
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)
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)
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)
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()

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

_comp_year69, _i, _load, _match, _parse_ddd, _parse_impl, _parse_iso2, _parse_jis, _parse_vms, _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, ajd, amjd, civil, civilDate, commercial, cwday, cweek, cwyear, day_fraction, england, eql_p, equals, equals, getChronology, getDateTime, getDay, getHour, getJavaClass, getJulianDayNumber, getMinute, getMonth, getNanos, getSecond, getYear, gregorian, gregorian_leap_p, gregorian_p, hash, hashCode, hour, initialize, initialize, initialize, initialize_copy, inspect, isJulian, italy, jd, jd, jd, 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, next, next_day, next_month, next_month, next_year, next_year, offset, op_cmp, op_eqq, op_minus, op_plus, ordinal, prev_day, prev_month, prev_month, prev_year, prev_year, sec_fraction, second, shift_bw, shift_fw, start, to_date, to_datetime, toDate, today, today, toInstant, toLocalDate, valid_civil_p, valid_commercial_p, valid_jd_p, valid_jd_p, valid_ordinal_p, 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, dig, dig1, dig2, eqlInternal, equalInternal, finishObjectClass, getNativeClassIndex, inspect, puts, specificEval, toRubyString, toString

Methods inherited from class org.jruby.RubyBasicObject

addFinalizer, addFinalizer, anyToString, asJavaString, asString, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callSuper, checkArrayType, checkCallMethod, checkCallMethod, checkFrozen, checkStringType, cloneSetup, compareTo, convertToArray, convertToFloat, convertToHash, convertToInteger, convertToInteger, convertToInteger, convertToString, copyInstanceVariablesInto, copySpecialInstanceVariables, dataGetStruct, dataGetStructChecked, dataWrapStruct, decode, display, dup, dupFinalizer, dupSetup, ensureInstanceVariablesSettable, eql, eql_p, equal_p, evalUnder, extend, fastGetInstanceVariable, fastGetInternalVariable, fastHasInstanceVariable, fastHasInternalVariable, fastSetInstanceVariable, fastSetInternalVariable, finishBasicObjectClass, forEachInstanceVariable, forEachInstanceVariableName, freeze, frozen_p, getCurrentContext, getFFIHandle, getFlag, getInstanceEvalClass, getInstanceEvalClass, getInstanceVariable, getInstanceVariableList, getInstanceVariableNameList, getInstanceVariables, getInternalVariable, getInternalVariables, getMarshalVariableList, getMetaClass, getMetaClass, getNativeHandle, getNativeTypeIndex, getObjectId, getRuntime, getSingletonClass, getSingletonClassClone, getSingletonClassCloneAndAttach, getSingletonClassCloneAndAttach, getType, getVariable, getVariableCount, getVariableList, getVariableNameList, hash, hashyInspect, hasInstanceVariable, hasInstanceVariables, hasInternalVariable, hasVariables, id, infectBy, initialize, initialize_copy, inspect, inspectHashCode, instance_eval, instance_eval, instance_eval, instance_eval, instance_eval, instance_exec, instance_of_p, instance_variable_defined_p, instance_variable_get, instance_variable_set, instance_variables, isBuiltin, isClass, isFalse, isFrozen, isImmediate, isModule, isNil, isSpecialConst, isSpecialObject, isTaint, isTrue, isUntrusted, kind_of_p, makeMetaClass, makeMetaClass, makeMetaClassBootstrap, method, method, method, method_missing, methods, methods, nil_p, nonFixnumHashCode, nonFixnumHashCode, OBJ_INIT_COPY, objInitCopy, op_equal, op_match, op_not, op_not_equal, op_not_match, private_methods, protected_methods, public_methods, rbClone, rbClone, rbInspect, remove_instance_variable, removeFinalizers, removeInstanceVariable, removeInternalVariable, respond_to_p, respond_to_p, respondsTo, respondsToMissing, respondsToMissing, send, send, send, send, send, setFFIHandle, setFlag, setFrozen, setInstanceVariable, setInternalVariable, setMetaClass, setNativeHandle, setTaint, setUntrusted, setVariable, singleton_method, singleton_method, singleton_method_added, singleton_method_removed, singleton_method_undefined, singleton_methods, singletonClass, specificEval, specificEval, specificEval, specificEval, syncVariables, syncVariables, taint, taint, tainted_p, testFrozen, testFrozen, to_a, to_a, to_s, trust, type, 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

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

checkStringType19, dup, marshalLiveVariables

Constructor Details

RubyDateTime

protected RubyDateTime(Ruby runtime,
 RubyClass klass)

RubyDateTime

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

RubyDateTime

@Deprecated(since="10.0")
public RubyDateTime(Ruby runtime,
 org.joda.time.DateTime dt)

Deprecated.

RubyDateTime

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

Method Details

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)

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

to_s

public RubyString to_s(ThreadContext context)

Overrides:

to_s in class RubyDate

to_date

public RubyDate to_date(ThreadContext context)

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

Type Parameters:

T - type

Parameters:

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

Returns:

java type

See Also:

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