Package org.jruby

Class RubyTime

java.lang.Object

org.jruby.RubyBasicObject

org.jruby.RubyObject

org.jruby.RubyTime

All Implemented Interfaces:

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

public class RubyTime
extends RubyObject

The Time class.

Author:

chadfowler, jpetersen

See Also:

• 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
static final int	TIME_SCALE
static final String	UTC

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

Constructor	Description
RubyTime(Ruby runtime, RubyClass rubyClass)
RubyTime(Ruby runtime, RubyClass rubyClass, org.joda.time.DateTime dt)
RubyTime(Ruby runtime, RubyClass rubyClass, org.joda.time.DateTime dt, boolean tzRelative)

Method Summary

Modifier and Type	Method	Description
RubyString	asctime()
static IRubyObject	at(ThreadContext context, IRubyObject recv, IRubyObject arg)
static IRubyObject	at(ThreadContext context, IRubyObject recv, IRubyObject[] args)
static IRubyObject	at(ThreadContext context, IRubyObject recv, IRubyObject arg1, IRubyObject arg2)
static IRubyObject	at(ThreadContext context, IRubyObject recv, IRubyObject arg1, IRubyObject arg2, IRubyObject arg3)
RubyTime	ceil(ThreadContext context, IRubyObject[] args)
static double	convertTimeInterval(ThreadContext context, IRubyObject sec)
static RubyClass	createTimeClass(ThreadContext context, RubyClass Object, RubyModule Comparable)
RubyString	dump(IRubyObject[] args, Block unusedBlock)	Deprecated.
RubyString	dump(ThreadContext context)
RubyString	dump(ThreadContext context, IRubyObject arg)
IRubyObject	eql_p(ThreadContext context, IRubyObject otherArg)
RubyTime	floor(ThreadContext context, IRubyObject[] args)
RubyBoolean	friday_p(ThreadContext context)
org.joda.time.DateTime	getDateTime()
int	getDay()
static String	getEnvTimeZone(Ruby runtime)	Deprecated.
static String	getEnvTimeZone(ThreadContext context)
RubyTime	getgm()
int	getHour()
Class<?>	getJavaClass()	Will return the Java interface that most closely can represent this object, when working through Java integration translations.
Date	getJavaDate()
final RubyTime	getlocal()
RubyTime	getlocal(ThreadContext context)
RubyTime	getlocal(ThreadContext context, IRubyObject off)
static org.joda.time.DateTimeZone	getLocalTimeZone(Ruby runtime)	Deprecated.
static org.joda.time.DateTimeZone	getLocalTimeZone(ThreadContext context)
int	getMicros()	Return the micro-seconds of this time.
int	getMinute()
int	getMonth()
int	getNanos()	Return the nano-seconds of this time.
ClassIndex	getNativeClassIndex()	This is overridden in the other concrete Java builtins to provide a fast way to determine what type they are.
long	getNSec()	Get the nano-second (only) part of the time.
static String	getRubyTimeZoneName(String envTZ, org.joda.time.DateTime dt)
static String	getRubyTimeZoneName(Ruby runtime, org.joda.time.DateTime dt)	Deprecated. Use getRubyTimeZoneName(ThreadContext, DateTime) instead.
static String	getRubyTimeZoneName(ThreadContext context, org.joda.time.DateTime dt)
int	getSecond()
long	getTimeInMicros()
long	getTimeInMillis()
static org.joda.time.DateTimeZone	getTimeZone(Ruby runtime, long seconds)	Deprecated.
static org.joda.time.DateTimeZone	getTimeZone(ThreadContext context, long seconds)
static org.joda.time.DateTimeZone	getTimeZoneFromString(Ruby runtime, String zone)	Deprecated.
static org.joda.time.DateTimeZone	getTimeZoneFromTZString(Ruby runtime, String zone)	Deprecated.
static org.joda.time.DateTimeZone	getTimeZoneFromTZString(ThreadContext context, String zone)
static org.joda.time.DateTimeZone	getTimeZoneFromUtcOffset(ThreadContext context, IRubyObject arg)
static org.joda.time.DateTimeZone	getTimeZoneWithOffset(Ruby runtime, String zoneName, int offset)	Deprecated.
static org.joda.time.DateTimeZone	getTimeZoneWithOffset(ThreadContext context, String zoneName, int offset)
long	getUSec()	Get the micro-second (only) part of the time.
int	getYear()
String	getZoneName()	Deprecated.
RubyBoolean	gmt()	Deprecated.
RubyBoolean	gmt(ThreadContext context)
RubyInteger	gmt_offset()	Deprecated.
RubyInteger	gmt_offset(ThreadContext context)
RubyTime	gmtime()	Deprecated.
RubyTime	gmtime(ThreadContext context)
RubyFixnum	hash(ThreadContext context)	Will return the hash code of this object.
int	hashCode()	This override does not do "checked" dispatch since Object usually has #hash defined.
RubyInteger	hour()	Deprecated.
RubyInteger	hour(ThreadContext context)
IRubyObject	initialize(ThreadContext context)
IRubyObject	initialize(ThreadContext context, IRubyObject[] args)
IRubyObject	initialize(ThreadContext context, IRubyObject year, IRubyObject month, IRubyObject day, IRubyObject hour, IRubyObject minute, IRubyObject second, IRubyObject usec, IRubyObject zone)
IRubyObject	initialize_copy(ThreadContext context, IRubyObject original)	Initializes this object as a copy of the original, that is the parameter to this object.
IRubyObject	inspect(ThreadContext context)	Returns a string containing a human-readable representation of obj.
static RaiseException	invalidUTCOffset(Ruby runtime)	Deprecated. Use invalidUTCOffset(ThreadContext) instead
static RaiseException	invalidUTCOffset(Ruby runtime, IRubyObject value)	Deprecated. Use invalidUTCOffset(ThreadContext) instead
static RaiseException	invalidUTCOffset(ThreadContext context)
static RaiseException	invalidUTCOffset(ThreadContext context, IRubyObject value)
RubyBoolean	isdst()	Deprecated.
RubyBoolean	isdst(ThreadContext context)
boolean	isUTC()
static RubyTime	load(IRubyObject recv, IRubyObject from, Block block)	Deprecated.
static RubyTime	load(ThreadContext context, IRubyObject recv, IRubyObject from)
static RubyTime	local(ThreadContext context, IRubyObject recv, IRubyObject[] args)
final RubyTime	localtime()
RubyTime	localtime(ThreadContext context)
RubyTime	localtime(ThreadContext context, IRubyObject arg)
RubyInteger	mday()	Deprecated.
RubyInteger	mday(ThreadContext context)
RubyObject	mdump()	Deprecated.
long	microseconds()	Deprecated. use getMicros() instead
RubyInteger	min()	Deprecated.
RubyInteger	min(ThreadContext context)
RubyBoolean	monday_p(ThreadContext context)
RubyInteger	month()	Deprecated.
RubyInteger	month(ThreadContext context)
static RubyTime	newInstance(ThreadContext context, IRubyObject recv, IRubyObject[] args)
static IRubyObject	newInstance(ThreadContext context, IRubyObject recv, IRubyObject[] args, Block block)	Deprecated. Use newInstance(ThreadContext, IRubyObject, IRubyObject[])
static RubyTime	newTime(Ruby runtime, long milliseconds)
static RubyTime	newTime(Ruby runtime, org.joda.time.DateTime dt)
static RubyTime	newTime(Ruby runtime, org.joda.time.DateTime dt, long nsec)	Create new (Ruby) Time instance.
static RubyTime	newTimeFromNanoseconds(Ruby runtime, long nanoseconds)	Deprecated.
static RubyTime	newTimeFromNanoseconds(ThreadContext context, long nanoseconds)
RubyInteger	nsec()	Deprecated.
RubyInteger	nsec(ThreadContext context)	Get the fractional part of time in nanoseconds.
IRubyObject	op_cmp(ThreadContext context, IRubyObject other)
IRubyObject	op_eqq(ThreadContext context, IRubyObject other)	rb_equal The Ruby "===" method is used by default in case/when statements.
IRubyObject	op_equal(ThreadContext context, IRubyObject other)	rb_obj_equal Will by default use identity equality to compare objects.
IRubyObject	op_ge(ThreadContext context, IRubyObject other)
IRubyObject	op_gt(ThreadContext context, IRubyObject other)
IRubyObject	op_le(ThreadContext context, IRubyObject other)
IRubyObject	op_lt(ThreadContext context, IRubyObject other)
IRubyObject	op_minus(IRubyObject other)
IRubyObject	op_minus(ThreadContext context, IRubyObject other)
IRubyObject	op_plus(IRubyObject other)
IRubyObject	op_plus(ThreadContext context, IRubyObject other)
RubyTime	round(ThreadContext context, IRubyObject[] args)
static IRubyObject	s_new(IRubyObject recv, IRubyObject[] args, Block block)	Deprecated. Use newInstance(ThreadContext, IRubyObject, IRubyObject[])
RubyBoolean	saturday_p(ThreadContext context)
RubyInteger	sec()	Deprecated.
RubyInteger	sec(ThreadContext context)
void	setDateTime(org.joda.time.DateTime dt)
void	setMicros(int micros)	Sets the microsecond part for this Time object.
void	setMicroseconds(long micros)	Deprecated. use setMicros(int) instead
void	setNanos(int nanos)	Sets the nanosecond part for this Time object.
void	setNSec(long nsec)	Set the nano-second (only) part for this time.
void	setUSec(long usec)	Set the micro-second (only) part of the time.
void	setZoneObject(IRubyObject zone)
RubyString	strftime(IRubyObject format)	Deprecated.
RubyString	strftime(ThreadContext context, IRubyObject format)
IRubyObject	subsec()	Deprecated.
RubyNumeric	subsec(ThreadContext context)
RubyBoolean	sunday_p(ThreadContext context)
RubyBoolean	thursday_p(ThreadContext context)
static RubyTime	timeZoneLocal(ThreadContext context, IRubyObject off, RubyTime time)
RubyArray	to_a(ThreadContext context)
RubyFloat	to_f()
RubyInteger	to_i()	Deprecated.
RubyInteger	to_i(ThreadContext context)
long	to_i_long()
IRubyObject	to_r(ThreadContext context)
IRubyObject	to_s(ThreadContext context)
Instant	toInstant()
<T> T	toJava(Class<T> target)	Convert the object to the specified Java class, if possible.
LocalDateTime	toLocalDateTime()
OffsetDateTime	toOffsetDateTime()
String	toString()	The default toString method is just a wrapper that calls the Ruby "to_s" method.
ZonedDateTime	toZonedDateTime()
RubyBoolean	tuesday_p(ThreadContext context)
void	updateCal(org.joda.time.DateTime dt)	Deprecated.
RubyInteger	usec()	Deprecated.
RubyInteger	usec(ThreadContext context)	Get the microsecond part of this time value.
static RubyTime	utc(ThreadContext context, IRubyObject recv, IRubyObject[] args)
RubyInteger	wday()	Deprecated.
RubyInteger	wday(ThreadContext context)
RubyBoolean	wednesday_p(ThreadContext context)
RubyInteger	yday()	Deprecated.
RubyInteger	yday(ThreadContext context)
RubyInteger	year()	Deprecated.
RubyInteger	year(ThreadContext context)
IRubyObject	zone()	Deprecated. Use zone(ThreadContext) instead.
IRubyObject	zone(ThreadContext context)
static boolean	zoneLocalTime(ThreadContext context, IRubyObject zone, RubyTime time)
static boolean	zoneTimeLocal(ThreadContext context, IRubyObject zone, RubyTime time)

Methods inherited from class org.jruby.RubyObject

attachToObjectSpace, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, convertToType, dig, dig1, dig2, eqlInternal, equalInternal, equals, finishObjectClass, inspect, puts, specificEval, toRubyString

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_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_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_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

Field Details

UTC

public static final String UTC

See Also:

• Constant Field Values

TIME_SCALE

public static final int TIME_SCALE

See Also:

• Constant Field Values

Constructor Details

RubyTime

public RubyTime(Ruby runtime,
 RubyClass rubyClass)

RubyTime

public RubyTime(Ruby runtime,
 RubyClass rubyClass,
 org.joda.time.DateTime dt)

RubyTime

public RubyTime(Ruby runtime,
 RubyClass rubyClass,
 org.joda.time.DateTime dt,
 boolean tzRelative)

Method Details

getNativeClassIndex

public ClassIndex getNativeClassIndex()

Description copied from class: RubyObject

This is overridden in the other concrete Java builtins to provide a fast way to determine what type they are. Will generally return a value from org.jruby.runtime.ClassIndex

Specified by:

getNativeClassIndex in interface CoreObjectType

Overrides:

getNativeClassIndex in class RubyObject

Returns:

the ClassIndex of the native type this object was constructed from

See Also:

• ClassIndex

getEnvTimeZone

@Deprecated(since="10.0")
public static String getEnvTimeZone(Ruby runtime)

Deprecated.

getEnvTimeZone

public static String getEnvTimeZone(ThreadContext context)

getLocalTimeZone

@Deprecated(since="10.0")
public static org.joda.time.DateTimeZone getLocalTimeZone(Ruby runtime)

Deprecated.

getLocalTimeZone

public static org.joda.time.DateTimeZone getLocalTimeZone(ThreadContext context)

getTimeZoneFromTZString

@Deprecated(since="10.0")
public static org.joda.time.DateTimeZone getTimeZoneFromTZString(Ruby runtime,
 String zone)

Deprecated.

getTimeZoneFromTZString

public static org.joda.time.DateTimeZone getTimeZoneFromTZString(ThreadContext context,
 String zone)

getTimeZoneFromString

@Deprecated
public static org.joda.time.DateTimeZone getTimeZoneFromString(Ruby runtime,
 String zone)

Deprecated.

getTimeZoneFromUtcOffset

public static org.joda.time.DateTimeZone getTimeZoneFromUtcOffset(ThreadContext context,
 IRubyObject arg)

invalidUTCOffset

@Deprecated(since="10.0")
public static RaiseException invalidUTCOffset(Ruby runtime)

Deprecated.

Use invalidUTCOffset(ThreadContext) instead

Parameters:

runtime -

Returns:

""

invalidUTCOffset

public static RaiseException invalidUTCOffset(ThreadContext context)

invalidUTCOffset

@Deprecated(since="10.0")
public static RaiseException invalidUTCOffset(Ruby runtime,
 IRubyObject value)

Deprecated.

Use invalidUTCOffset(ThreadContext) instead

Parameters:

runtime -

Returns:

""

invalidUTCOffset

public static RaiseException invalidUTCOffset(ThreadContext context,
 IRubyObject value)

getTimeZone

@Deprecated(since="10.0")
public static org.joda.time.DateTimeZone getTimeZone(Ruby runtime,
 long seconds)

Deprecated.

getTimeZone

public static org.joda.time.DateTimeZone getTimeZone(ThreadContext context,
 long seconds)

getTimeZoneWithOffset

@Deprecated(since="10.0")
public static org.joda.time.DateTimeZone getTimeZoneWithOffset(Ruby runtime,
 String zoneName,
 int offset)

Deprecated.

getTimeZoneWithOffset

public static org.joda.time.DateTimeZone getTimeZoneWithOffset(ThreadContext context,
 String zoneName,
 int offset)

createTimeClass

public static RubyClass createTimeClass(ThreadContext context,
 RubyClass Object,
 RubyModule Comparable)

setNSec

public void setNSec(long nsec)

Set the nano-second (only) part for this time. Note that nsec means the 4 to 9 decimal places of sec fractional part of time. For example, 123456 for nsec means .000123456, not .123456000.

Parameters:

nsec - the nano second part only (4 to 9 decimal places) of time

getNSec

public long getNSec()

Get the nano-second (only) part of the time. Note that it returns the 4 to 9 decimal places, not the entire sec fraction part till nano. For example for an epoch second 1500000000.123456789 returns 456789.

Returns:

the nano second part (only) of time

setUSec

public void setUSec(long usec)

Set the micro-second (only) part of the time.

Parameters:

usec -

See Also:

• setNSec(long)

getUSec

public long getUSec()

Get the micro-second (only) part of the time.

Returns:

the micro-second only part of this time

See Also:

• getUSec()

setZoneObject

public void setZoneObject(IRubyObject zone)

updateCal

@Deprecated
public void updateCal(org.joda.time.DateTime dt)

Deprecated.

Use setDateTime(DateTime) instead.

newTime

public static RubyTime newTime(Ruby runtime,
 long milliseconds)

newTimeFromNanoseconds

@Deprecated(since="10.0")
public static RubyTime newTimeFromNanoseconds(Ruby runtime,
 long nanoseconds)

Deprecated.

newTimeFromNanoseconds

public static RubyTime newTimeFromNanoseconds(ThreadContext context,
 long nanoseconds)

newTime

public static RubyTime newTime(Ruby runtime,
 org.joda.time.DateTime dt)

newTime

public static RubyTime newTime(Ruby runtime,
 org.joda.time.DateTime dt,
 long nsec)

Create new (Ruby) Time instance. Note that dt of org.joda.time.DateTime represents the integer part and the fraction part to milliseconds, and nsec the nano part (4 to 9 decimal places). For example, RubyTime.newTime(rt, new DateTime(987000), 345678) creates an epoch second of 987.000345678, not 987000.345678.

Parameters:

runtime - the runtime

dt - the integer part of time + the fraction part in milliseconds

nsec - the nanos only party of the time (millis excluded)

Returns:

the new Time

See Also:

• setNSec(long)

initialize_copy

public IRubyObject initialize_copy(ThreadContext context,
 IRubyObject original)

Description copied from class: RubyBasicObject

Initializes this object as a copy of the original, that is the parameter to this object. Will make sure that the argument actually has the same real class as this object. It shouldn't be possible to initialize an object with something totally different.

Overrides:

initialize_copy in class RubyBasicObject

Parameters:

context - the thread context

original - the original

Returns:

a copy unless the same thing

gmtime

@Deprecated(since="10.0")
public RubyTime gmtime()

Deprecated.

gmtime

public RubyTime gmtime(ThreadContext context)

localtime

public final RubyTime localtime()

localtime

public RubyTime localtime(ThreadContext context)

localtime

public RubyTime localtime(ThreadContext context,
 IRubyObject arg)

gmt

public RubyBoolean gmt(ThreadContext context)

gmt

@Deprecated
public RubyBoolean gmt()

Deprecated.

isUTC

public boolean isUTC()

getgm

public RubyTime getgm()

getlocal

public final RubyTime getlocal()

getlocal

public RubyTime getlocal(ThreadContext context)

getlocal

public RubyTime getlocal(ThreadContext context,
 IRubyObject off)

strftime

@Deprecated
public RubyString strftime(IRubyObject format)

Deprecated.

strftime

public RubyString strftime(ThreadContext context,
 IRubyObject format)

op_equal

public IRubyObject op_equal(ThreadContext context,
 IRubyObject other)

Description copied from class: RubyBasicObject

rb_obj_equal Will by default use identity equality to compare objects. This follows the Ruby semantics. The name of this method doesn't follow the convention because hierarchy problems

Specified by:

op_equal in interface IRubyObject

Overrides:

op_equal in class RubyBasicObject

op_ge

public IRubyObject op_ge(ThreadContext context,
 IRubyObject other)

op_gt

public IRubyObject op_gt(ThreadContext context,
 IRubyObject other)

op_le

public IRubyObject op_le(ThreadContext context,
 IRubyObject other)

op_lt

public IRubyObject op_lt(ThreadContext context,
 IRubyObject other)

op_plus

public IRubyObject op_plus(IRubyObject other)

op_plus

public IRubyObject op_plus(ThreadContext context,
 IRubyObject other)

op_minus

public IRubyObject op_minus(IRubyObject other)

op_minus

public IRubyObject op_minus(ThreadContext context,
 IRubyObject other)

op_eqq

public IRubyObject op_eqq(ThreadContext context,
 IRubyObject other)

Description copied from class: RubyObject

rb_equal The Ruby "===" method is used by default in case/when statements. The Object implementation first checks Java identity equality and then calls the "==" method too.

Specified by:

op_eqq in interface IRubyObject

Overrides:

op_eqq in class RubyObject

op_cmp

public IRubyObject op_cmp(ThreadContext context,
 IRubyObject other)

Overrides:

op_cmp in class RubyBasicObject

eql_p

public IRubyObject eql_p(ThreadContext context,
 IRubyObject otherArg)

Overrides:

eql_p in class RubyBasicObject

asctime

public RubyString asctime()

to_s

public IRubyObject to_s(ThreadContext context)

Overrides:

to_s in class RubyBasicObject

inspect

public IRubyObject inspect(ThreadContext context)

Description copied from class: RubyBasicObject

Returns a string containing a human-readable representation of obj. If not overridden, uses the to_s method to generate the string. [ 1, 2, 3..4, 'five' ].inspect #=> "[1, 2, 3..4, \"five\"]" Time.new.inspect #=> "Wed Apr 09 08:54:39 CDT 2003"

Specified by:

inspect in interface IRubyObject

Overrides:

inspect in class RubyBasicObject

toString

public String toString()

Description copied from class: RubyObject

The default toString method is just a wrapper that calls the Ruby "to_s" method.

Overrides:

toString in class RubyObject

Returns:

string representation

to_a

public RubyArray to_a(ThreadContext context)

Overrides:

to_a in class RubyBasicObject

to_f

public RubyFloat to_f()

to_i

public RubyInteger to_i(ThreadContext context)

to_i_long

public long to_i_long()

to_i

@Deprecated(since="9.4-")
public RubyInteger to_i()

Deprecated.

nsec

public RubyInteger nsec(ThreadContext context)

Get the fractional part of time in nanoseconds. Note that this returns the entire fraction part of the time in nanosecond, unlike RubyTime#getNSec. This method represents Ruby's nsec method.

Returns:

the (sec) fractional part of time (in nanos)

nsec

@Deprecated(since="9.4-")
public RubyInteger nsec()

Deprecated.

to_r

public IRubyObject to_r(ThreadContext context)

usec

public RubyInteger usec(ThreadContext context)

Get the microsecond part of this time value.

Returns:

the (whole) microsecond part of time

usec

@Deprecated
public RubyInteger usec()

Deprecated.

getTimeInMicros

public long getTimeInMicros()

Returns:

the total time in microseconds

See Also:

• getTimeInMillis()

getMicros

public int getMicros()

Return the micro-seconds of this time.

Returns:

micro seconds (only)

See Also:

• getTimeInMicros()

setMicros

public void setMicros(int micros)

Sets the microsecond part for this Time object.

Parameters:

micros - the microseconds to be set

See Also:

• getMicros()

setMicroseconds

@Deprecated(since="9.4-")
public void setMicroseconds(long micros)

Deprecated.

use setMicros(int) instead

microseconds

@Deprecated(since="9.4-")
public long microseconds()

Deprecated.

use getMicros() instead

getNanos

public int getNanos()

Return the nano-seconds of this time.

Returns:

nano seconds (only)

setNanos

public void setNanos(int nanos)

Sets the nanosecond part for this Time object.

Parameters:

nanos - the nanoseconds to be set

See Also:

• getNanos()

sec

public RubyInteger sec(ThreadContext context)

sec

@Deprecated(since="10.0")
public RubyInteger sec()

Deprecated.

min

public RubyInteger min(ThreadContext context)

min

@Deprecated(since="10.0")
public RubyInteger min()

Deprecated.

hour

public RubyInteger hour(ThreadContext context)

hour

@Deprecated(since="10.0")
public RubyInteger hour()

Deprecated.

mday

public RubyInteger mday(ThreadContext context)

mday

@Deprecated(since="10.0")
public RubyInteger mday()

Deprecated.

month

public RubyInteger month(ThreadContext context)

month

@Deprecated(since="10.0")
public RubyInteger month()

Deprecated.

year

public RubyInteger year(ThreadContext context)

year

@Deprecated(since="10.0")
public RubyInteger year()

Deprecated.

wday

public RubyInteger wday(ThreadContext context)

wday

@Deprecated(since="10.0")
public RubyInteger wday()

Deprecated.

yday

public RubyInteger yday(ThreadContext context)

yday

@Deprecated(since="10.0")
public RubyInteger yday()

Deprecated.

sunday_p

public RubyBoolean sunday_p(ThreadContext context)

monday_p

public RubyBoolean monday_p(ThreadContext context)

tuesday_p

public RubyBoolean tuesday_p(ThreadContext context)

wednesday_p

public RubyBoolean wednesday_p(ThreadContext context)

thursday_p

public RubyBoolean thursday_p(ThreadContext context)

friday_p

public RubyBoolean friday_p(ThreadContext context)

saturday_p

public RubyBoolean saturday_p(ThreadContext context)

subsec

@Deprecated
public IRubyObject subsec()

Deprecated.

subsec

public RubyNumeric subsec(ThreadContext context)

gmt_offset

public RubyInteger gmt_offset(ThreadContext context)

gmt_offset

@Deprecated(since="9.4-")
public RubyInteger gmt_offset()

Deprecated.

isdst

public RubyBoolean isdst(ThreadContext context)

isdst

@Deprecated
public RubyBoolean isdst()

Deprecated.

zone

@Deprecated(since="10.0")
public IRubyObject zone()

Deprecated.

Use zone(ThreadContext) instead.

Returns:

""

zone

public IRubyObject zone(ThreadContext context)

getZoneName

@Deprecated(since="10.0")
public String getZoneName()

Deprecated.

getRubyTimeZoneName

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

Deprecated.

Use getRubyTimeZoneName(ThreadContext, DateTime) instead.

Parameters:

runtime -

dt -

Returns:

""

getRubyTimeZoneName

public static String getRubyTimeZoneName(ThreadContext context,
 org.joda.time.DateTime dt)

getRubyTimeZoneName

public static String getRubyTimeZoneName(String envTZ,
 org.joda.time.DateTime dt)

setDateTime

public void setDateTime(org.joda.time.DateTime dt)

getDateTime

public org.joda.time.DateTime getDateTime()

hash

public RubyFixnum hash(ThreadContext context)

Description copied from class: RubyBasicObject

Will return the hash code of this object. In comparison to MRI, this method will use the Java identity hash code instead of using rb_obj_id, since the usage of id in JRuby will incur the cost of some. ObjectSpace maintenance.

Overrides:

hash in class RubyBasicObject

Parameters:

context - the current thread context

Returns:

the hash value

hashCode

public int hashCode()

Description copied from class: RubyObject

This override does not do "checked" dispatch since Object usually has #hash defined.

Overrides:

hashCode in class RubyObject

Returns:

the hash code

See Also:

• RubyBasicObject.hashCode()

dump

public RubyString dump(ThreadContext context)

dump

public RubyString dump(ThreadContext context,
 IRubyObject arg)

dump

@Deprecated
public RubyString dump(IRubyObject[] args,
 Block unusedBlock)

Deprecated.

mdump

@Deprecated
public RubyObject mdump()

Deprecated.

round

public RubyTime round(ThreadContext context,
 IRubyObject[] args)

floor

public RubyTime floor(ThreadContext context,
 IRubyObject[] args)

ceil

public RubyTime ceil(ThreadContext context,
 IRubyObject[] args)

s_new

@Deprecated
public static IRubyObject s_new(IRubyObject recv,
 IRubyObject[] args,
 Block block)

Deprecated.

Use newInstance(ThreadContext, IRubyObject, IRubyObject[])

newInstance

@Deprecated
public static IRubyObject newInstance(ThreadContext context,
 IRubyObject recv,
 IRubyObject[] args,
 Block block)

Deprecated.

Use newInstance(ThreadContext, IRubyObject, IRubyObject[])

newInstance

public static RubyTime newInstance(ThreadContext context,
 IRubyObject recv,
 IRubyObject[] args)

at

public static IRubyObject at(ThreadContext context,
 IRubyObject recv,
 IRubyObject arg)

at

public static IRubyObject at(ThreadContext context,
 IRubyObject recv,
 IRubyObject arg1,
 IRubyObject arg2)

at

public static IRubyObject at(ThreadContext context,
 IRubyObject recv,
 IRubyObject arg1,
 IRubyObject arg2,
 IRubyObject arg3)

at

public static IRubyObject at(ThreadContext context,
 IRubyObject recv,
 IRubyObject[] args)

local

public static RubyTime local(ThreadContext context,
 IRubyObject recv,
 IRubyObject[] args)

initialize

public IRubyObject initialize(ThreadContext context)

Overrides:

initialize in class RubyBasicObject

initialize

public IRubyObject initialize(ThreadContext context,
 IRubyObject[] args)

initialize

public IRubyObject initialize(ThreadContext context,
 IRubyObject year,
 IRubyObject month,
 IRubyObject day,
 IRubyObject hour,
 IRubyObject minute,
 IRubyObject second,
 IRubyObject usec,
 IRubyObject zone)

utc

public static RubyTime utc(ThreadContext context,
 IRubyObject recv,
 IRubyObject[] args)

load

@Deprecated
public static RubyTime load(IRubyObject recv,
 IRubyObject from,
 Block block)

Deprecated.

load

public static RubyTime load(ThreadContext context,
 IRubyObject recv,
 IRubyObject from)

getJavaClass

public Class<?> getJavaClass()

Description copied from class: RubyBasicObject

Will return the Java interface that most closely can represent this object, when working through Java integration translations.

Specified by:

getJavaClass in interface IRubyObject

Overrides:

getJavaClass in class RubyBasicObject

Returns:

the true Java class of this (Ruby) object

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 RubyBasicObject

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

getTimeInMillis

public long getTimeInMillis()

Returns:

millis since epoch this (date-time) value represents

Since:

9.2 (public)

getYear

public int getYear()

Returns:

year

Since:

9.2

getMonth

public int getMonth()

Returns:

month-of-year (1..12)

Since:

9.2

getDay

public int getDay()

Returns:

day-of-month

Since:

9.2

getHour

public int getHour()

Returns:

hour-of-day (0..23)

Since:

9.2

getMinute

public int getMinute()

Returns:

minute-of-hour

Since:

9.2

getSecond

public int getSecond()

Returns:

second-of-minute

Since:

9.2

getJavaDate

public Date getJavaDate()

Returns:

a Java (legacy) Date instance

Since:

1.7

toInstant

public Instant toInstant()

Returns:

an instant

Since:

9.2

toLocalDateTime

public LocalDateTime toLocalDateTime()

Returns:

a date time

Since:

9.2

toZonedDateTime

public ZonedDateTime toZonedDateTime()

Returns:

a date time

Since:

9.2

toOffsetDateTime

public OffsetDateTime toOffsetDateTime()

Returns:

a date time

Since:

9.2

convertTimeInterval

public static double convertTimeInterval(ThreadContext context,
 IRubyObject sec)

zoneTimeLocal

public static boolean zoneTimeLocal(ThreadContext context,
 IRubyObject zone,
 RubyTime time)

zoneLocalTime

public static boolean zoneLocalTime(ThreadContext context,
 IRubyObject zone,
 RubyTime time)

timeZoneLocal

public static RubyTime timeZoneLocal(ThreadContext context,
 IRubyObject off,
 RubyTime time)