End of Life Ruby 3.1 has reached end of life and gets no more fixes. Switch to Ruby 4.0 →

class method

Time.local

Time.local(year, month=1, day=1, hour=0, min=0, sec_i=0, usec=0) → new_time

Time.local(sec, min, hour, day, month, year, dummy, dummy, dummy, dummy) → new_time

static VALUE
time_s_mktime(int argc, VALUE *argv, VALUE klass)
{
    struct vtm vtm;

    time_arg(argc, argv, &vtm);
    return time_localtime(time_new_timew(klass, timelocalw(&vtm)));
}

Returns a new Time object based the on given arguments; its timezone is the local timezone.

In the first form (up to seven arguments), argument year is required.

Example

Time.local(2000)                   # => 2000-01-01 00:00:00 -0600
Time.local(0, 1, 2, 3, 4, 5, 6.5)  # => 0000-01-02 03:04:05.0000065 -0600

In the second form, all ten arguments are required, though the last four are ignored. This form is useful for creating a time from a 10-element array such as those returned by to_a.

Example

array = Time.now.to_a
p array # => [57, 26, 13, 24, 4, 2021, 6, 114, true, "Central Daylight Time"]
array[5] = 2000
Time.local(*array)  # => 2000-04-24 13:26:57 -0500

Parameters:

year: an integer year.
month: a month value, which may be:
- An integer month in the range 1..12.
- A 3-character string that matches regular expression /jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec/i.
day: an integer day in the range 1..31 (less than 31 for some months).
hour: an integer hour in the range 0..23.
min: an integer minute in the range 0..59.
isec_i is the integer number of seconds in the range 0..60.
usec is the number of microseconds (Integer, Float, or Rational) in the range 0..1000000.

Alias: Time.mktime.

Related: Time.utc.

See also .json_create .new .iso8601 .now also in 4.1 · 4.0 · 3.4 · 3.3 · 3.2 · 3.0

‹ prev.json_create next ›.new