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 and Description
static BigDecimal	ONE_BILLION_BD
static BigDecimal	ONE_MILLION_BD
static BigInteger	ONE_MILLION_BI
static BigDecimal	ONE_THOUSAND_BD
static String	UTC

Fields inherited from class org.jruby.RubyObject

FIELD_ALLOCATED_CLASSES, FIELD_ALLOCATORS, IVAR_INSPECTING_OBJECT_ALLOCATOR, OBJECT_ALLOCATOR, OBJECT_VAR0_ALLOCATOR, OBJECT_VAR1_ALLOCATOR, OBJECT_VAR2_ALLOCATOR, OBJECT_VAR3_ALLOCATOR, OBJECT_VAR4_ALLOCATOR, OBJECT_VAR5_ALLOCATOR, OBJECT_VAR6_ALLOCATOR, OBJECT_VAR7_ALLOCATOR, OBJECT_VAR8_ALLOCATOR, OBJECT_VAR9_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

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

Method Summary

Modifier and Type	Method and Description
RubyString	asctime()
static IRubyObject	at(ThreadContext context, IRubyObject recv, IRubyObject arg)
static IRubyObject	at(ThreadContext context, IRubyObject recv, IRubyObject arg1, IRubyObject arg2)
static double	convertTimeInterval(ThreadContext context, IRubyObject sec)
static RubyClass	createTimeClass(Ruby runtime)
RubyString	dump(IRubyObject[] args, Block unusedBlock)
IRubyObject	eql_p(IRubyObject other) rb_obj_equal Just like "==" and "equal?", "eql?" will use identity equality for Object.
org.joda.time.DateTime	getDateTime()
RubyTime	getgm()
Class<?>	getJavaClass() Will return the Java interface that most closely can represent this object, when working through JAva integration translations.
Date	getJavaDate()
RubyTime	getlocal()
RubyTime	getlocal19(ThreadContext context, IRubyObject[] args)
static org.joda.time.DateTimeZone	getLocalTimeZone(Ruby runtime)
ClassIndex	getNativeClassIndex() This is overridden in the other concrete Java builtins to provide a fast way to determine what type they are.
long	getNSec()
static String	getRubyTimeZoneName(Ruby runtime, org.joda.time.DateTime dt)
static String	getRubyTimeZoneName(String envTZ, org.joda.time.DateTime dt)
protected long	getTimeInMillis()
static org.joda.time.DateTimeZone	getTimeZone(Ruby runtime, long seconds)
static org.joda.time.DateTimeZone	getTimeZoneFromString(Ruby runtime, String zone)
static org.joda.time.DateTimeZone	getTimeZoneFromTZString(Ruby runtime, String zone)
static org.joda.time.DateTimeZone	getTimeZoneFromUtcOffset(Ruby runtime, IRubyObject utcOffset)
static org.joda.time.DateTimeZone	getTimeZoneWithOffset(Ruby runtime, String zoneName, int offset)
long	getUSec()
RubyInteger	gmt_offset()
RubyBoolean	gmt()
RubyTime	gmtime()
RubyFixnum	hash() rb_obj_id Will return the hash code of this object.
RubyInteger	hour()
IRubyObject	initialize_copy(IRubyObject original) rb_obj_init_copy Initializes this object as a copy of the original, that is the parameter to this object.
IRubyObject	initialize(Block block)
RubyBoolean	isdst()
static RubyTime	load(IRubyObject recv, IRubyObject from, Block block)
RubyTime	localtime()
RubyTime	localtime19(ThreadContext context, IRubyObject[] args)
RubyInteger	mday()
RubyObject	mdump()
long	microseconds()
RubyInteger	min()
RubyInteger	month()
static RubyTime	new_local(IRubyObject recv, IRubyObject[] args)
static RubyTime	new_utc(IRubyObject recv, IRubyObject[] args)
static IRubyObject	new19(ThreadContext context, IRubyObject recv, IRubyObject[] args)
static IRubyObject	newInstance(ThreadContext context, IRubyObject recv)
static IRubyObject	newInstance(ThreadContext context, IRubyObject recv, IRubyObject[] args, Block block) Deprecated. Use newInstance(ThreadContext, IRubyObject)
static RubyTime	newTime(Ruby runtime, org.joda.time.DateTime dt)
static RubyTime	newTime(Ruby runtime, org.joda.time.DateTime dt, long nsec)
static RubyTime	newTime(Ruby runtime, long milliseconds)
RubyInteger	nsec()
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_minus19(ThreadContext context, IRubyObject other)
IRubyObject	op_plus(IRubyObject other)
IRubyObject	op_plus19(ThreadContext context, IRubyObject other)
RubyTime	round(ThreadContext context, IRubyObject[] args)
protected static RubyTime	s_mload(IRubyObject recv, RubyTime time, IRubyObject from)
static IRubyObject	s_new(IRubyObject recv, IRubyObject[] args, Block block)
RubyInteger	sec()
void	setDateTime(org.joda.time.DateTime dt)
void	setMicroseconds(long mic)
void	setNSec(long nsec)
void	setUSec(long usec)
RubyString	strftime(IRubyObject format)
IRubyObject	subsec()
RubyTime	succ()
RubyArray	to_a() rb_any_to_a call-seq: obj.to_a -> anArray Returns an array representation of obj.
RubyFloat	to_f()
RubyInteger	to_i()
IRubyObject	to_r(ThreadContext context)
IRubyObject	to_s() rb_any_to_s call-seq: obj.to_s => string Returns a string representing obj.
IRubyObject	to_s19()
Object	toJava(Class target) Convert the object to the specified Java class, if possible.
void	updateCal(org.joda.time.DateTime dt)
RubyInteger	usec()
RubyInteger	wday()
RubyInteger	yday()
RubyInteger	year()
IRubyObject	zone()

Methods inherited from class org.jruby.RubyObject

attachToObjectSpace, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, convertToType, createObjectClass, dig, eqlInternal, equalInternal, equals, hashCode, inspect, puts, specificEval, toString

Methods inherited from class org.jruby.RubyBasicObject

addFinalizer, anyToString, asJavaString, asString, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callSuper, checkArrayType, checkCallMethod, checkFrozen, checkStringType, checkStringType19, compareTo, convertToArray, convertToFloat, convertToHash, convertToInteger, convertToInteger, convertToInteger, convertToString, copyInstanceVariablesInto, copySpecialInstanceVariables, createBasicObjectClass, dataGetStruct, dataGetStructChecked, dataWrapStruct, 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, getNativeHandle, getNativeTypeIndex, getObjectId, getRuntime, getSingletonClass, getSingletonClassClone, getType, getVariable, getVariableCount, getVariableList, getVariableNameList, hashyInspect, hasInstanceVariable, hasInternalVariable, hasVariables, id, infectBy, initialize, initialize, initialize19, inspect, 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, isTaint, isTrue, isUntrusted, kind_of_p, makeMetaClass, method_missing19, method, method19, methods, methods, methods19, nil_p, nonFixnumHashCode, OBJ_INIT_COPY, objInitCopy, op_equal_19, op_match, op_match19, op_not_equal, op_not_match, op_not, private_methods, private_methods19, protected_methods, protected_methods19, public_methods, public_methods19, 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_added19, singleton_method_removed19, singleton_method_undefined19, singleton_methods, specificEval, specificEval, specificEval, specificEval, syncVariables, syncVariables, taint, taint, tainted_p, testFrozen, testFrozen, trust, type_deprecated, type, untaint, untrust, untrusted_p, 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 Detail

UTC

public static final String UTC

See Also:

Constant Field Values

ONE_MILLION_BD

public static final BigDecimal ONE_MILLION_BD

ONE_BILLION_BD

public static final BigDecimal ONE_BILLION_BD

ONE_MILLION_BI

public static final BigInteger ONE_MILLION_BI

ONE_THOUSAND_BD

public static final BigDecimal ONE_THOUSAND_BD

Constructor Detail

RubyTime

public RubyTime(Ruby runtime,
                RubyClass rubyClass)

RubyTime

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

Method Detail

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

See Also:

ClassIndex

getLocalTimeZone

public static org.joda.time.DateTimeZone getLocalTimeZone(Ruby runtime)

getTimeZoneFromTZString

public static org.joda.time.DateTimeZone getTimeZoneFromTZString(Ruby runtime,
                                                                 String zone)

getTimeZoneFromString

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

getTimeZoneFromUtcOffset

public static org.joda.time.DateTimeZone getTimeZoneFromUtcOffset(Ruby runtime,
                                                                  IRubyObject utcOffset)

getTimeZone

public static org.joda.time.DateTimeZone getTimeZone(Ruby runtime,
                                                     long seconds)

getTimeZoneWithOffset

public static org.joda.time.DateTimeZone getTimeZoneWithOffset(Ruby runtime,
                                                               String zoneName,
                                                               int offset)

createTimeClass

public static RubyClass createTimeClass(Ruby runtime)

setNSec

public void setNSec(long nsec)

getNSec

public long getNSec()

setUSec

public void setUSec(long usec)

getUSec

public long getUSec()

updateCal

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

getTimeInMillis

protected long getTimeInMillis()

newTime

public static RubyTime newTime(Ruby runtime,
                               long milliseconds)

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)

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:

Class

initialize_copy

public IRubyObject initialize_copy(IRubyObject original)

Description copied from class: RubyBasicObject

rb_obj_init_copy 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

succ

public RubyTime succ()

gmtime

public RubyTime gmtime()

localtime

public RubyTime localtime()

localtime19

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

gmt

public RubyBoolean gmt()

getgm

public RubyTime getgm()

getlocal

public RubyTime getlocal()

getlocal19

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

strftime

public RubyString strftime(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_plus19

public IRubyObject op_plus19(ThreadContext context,
                             IRubyObject other)

op_minus

public IRubyObject op_minus(IRubyObject other)

op_minus19

public IRubyObject op_minus19(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(IRubyObject other)

Description copied from class: RubyBasicObject

rb_obj_equal Just like "==" and "equal?", "eql?" will use identity equality for Object.

Overrides:

eql_p in class RubyBasicObject

asctime

public RubyString asctime()

to_s

public IRubyObject to_s()

Description copied from class: RubyBasicObject

rb_any_to_s call-seq: obj.to_s => string Returns a string representing obj. The default to_s prints the object's class and an encoding of the object id. As a special case, the top-level object that is the initial execution context of Ruby programs returns ``main.''

Overrides:

to_s in class RubyBasicObject

to_s19

public IRubyObject to_s19()

to_a

public RubyArray to_a()

Description copied from class: RubyBasicObject

rb_any_to_a call-seq: obj.to_a -> anArray Returns an array representation of obj. For objects of class Object and others that don't explicitly override the method, the return value is an array containing self. However, this latter behavior will soon be obsolete. self.to_a #=> -:1: warning: default `to_a' will be obsolete "hello".to_a #=> ["hello"] Time.new.to_a #=> [39, 54, 8, 9, 4, 2003, 3, 99, true, "CDT"] The default to_a method is deprecated.

Overrides:

to_a in class RubyBasicObject

to_f

public RubyFloat to_f()

to_i

public RubyInteger to_i()

nsec

public RubyInteger nsec()

to_r

public IRubyObject to_r(ThreadContext context)

usec

public RubyInteger usec()

setMicroseconds

public void setMicroseconds(long mic)

microseconds

public long microseconds()

sec

public RubyInteger sec()

min

public RubyInteger min()

hour

public RubyInteger hour()

mday

public RubyInteger mday()

month

public RubyInteger month()

year

public RubyInteger year()

wday

public RubyInteger wday()

yday

public RubyInteger yday()

subsec

public IRubyObject subsec()

gmt_offset

public RubyInteger gmt_offset()

isdst

public RubyBoolean isdst()

zone

public IRubyObject zone()

getRubyTimeZoneName

public static String getRubyTimeZoneName(Ruby runtime,
                                         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()

getJavaDate

public Date getJavaDate()

hash

public RubyFixnum hash()

Description copied from class: RubyBasicObject

rb_obj_id 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

dump

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

mdump

public RubyObject mdump()

initialize

public IRubyObject initialize(Block block)

round

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

s_new

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

newInstance

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

Deprecated. Use newInstance(ThreadContext, IRubyObject)

newInstance

public static IRubyObject newInstance(ThreadContext context,
                                      IRubyObject recv)

at

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

at

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

new_local

public static RubyTime new_local(IRubyObject recv,
                                 IRubyObject[] args)

new19

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

new_utc

public static RubyTime new_utc(IRubyObject recv,
                               IRubyObject[] args)

load

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

toJava

public Object toJava(Class 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

Parameters:

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

See Also:

IRubyObject.toJava(java.lang.Class)

convertTimeInterval

public static double convertTimeInterval(ThreadContext context,
                                         IRubyObject sec)

s_mload

protected static RubyTime s_mload(IRubyObject recv,
                                  RubyTime time,
                                  IRubyObject from)