Permalink
Fetching contributors…
Cannot retrieve contributors at this time
175 lines (152 sloc) 4.8 KB
/*
* Copyright (C)2005-2017 Haxe Foundation
*
* Permission is hereby granted, free of charge, to any person obtaining a
* copy of this software and associated documentation files (the "Software"),
* to deal in the Software without restriction, including without limitation
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
* and/or sell copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
* DEALINGS IN THE SOFTWARE.
*/
/**
The Date class provides a basic structure for date and time related
information. Date instances can be created by
- `new Date()` for a specific date,
- `Date.now()` to obtain information about the current time,
- `Date.fromTime()` with a given timestamp or
- `Date.fromString()` by parsing from a String.
There are some extra functions available in the `DateTools` class.
In the context of Haxe dates, a timestamp is defined as the number of
milliseconds elapsed since 1st January 1970.
**/
extern class Date
{
/**
Creates a new date object from the given arguments.
The behaviour of a Date instance is only consistent across platforms if
the the arguments describe a valid date.
- month: 0 to 11
- day: 1 to 31
- hour: 0 to 23
- min: 0 to 59
- sec: 0 to 59
**/
function new(year : Int, month : Int, day : Int, hour : Int, min : Int, sec : Int ) : Void;
/**
Returns the timestamp (in milliseconds) of the date. It might
only have a per-second precision depending on the platforms.
**/
function getTime() : Float;
/**
Returns the hours of `this` Date (0-23 range).
**/
function getHours() : Int;
/**
Returns the minutes of `this` Date (0-59 range).
**/
function getMinutes() : Int;
/**
Returns the seconds of `this` Date (0-59 range).
**/
function getSeconds() : Int;
/**
Returns the full year of `this` Date (4-digits).
**/
function getFullYear() : Int;
/**
Returns the month of `this` Date (0-11 range).
**/
function getMonth() : Int;
/**
Returns the day of `this` Date (1-31 range).
**/
function getDate() : Int;
/**
Returns the day of the week of `this` Date (0-6 range) where `0` is Sunday.
**/
function getDay() : Int;
/**
Returns a string representation of `this` Date, by using the
standard format [YYYY-MM-DD HH:MM:SS]. See `DateTools.format` for
other formating rules.
**/
function toString():String;
/**
Returns a Date representing the current local time.
**/
static function now() : Date;
/**
Returns a Date from timestamp `t`.
**/
static function fromTime( t : Float ) : Date;
/**
Returns a Date from a formated string `s`, with the following accepted
formats:
- `"YYYY-MM-DD hh:mm:ss"`
- `"YYYY-MM-DD"`
- `"hh:mm:ss"`
The first two formats are expressed in local time, the third in UTC
Epoch.
**/
static function fromString( s : String ) : Date;
#if flash
private static function __init__() : Void untyped {
var d : Dynamic = Date;
d.now = function() {
return __new__(Date);
};
d.fromTime = function(t){
var d : Date = __new__(Date);
d.setTime(t);
return d;
};
d.fromString = function(s : String) {
switch( s.length ) {
case 8: // hh:mm:ss
var k = s.split(":");
var d : Date = __new__(Date);
d.setTime(0);
d.setUTCHours(k[0]);
d.setUTCMinutes(k[1]);
d.setUTCSeconds(k[2]);
return d;
case 10: // YYYY-MM-DD
var k = s.split("-");
return new Date(cast k[0],cast k[1] - 1,cast k[2],0,0,0);
case 19: // YYYY-MM-DD hh:mm:ss
var k = s.split(" ");
var y = k[0].split("-");
var t = k[1].split(":");
return new Date(cast y[0],cast y[1] - 1,cast y[2],cast t[0],cast t[1],cast t[2]);
default:
throw "Invalid date format : " + s;
}
};
d.prototype[#if (as3 || no_flash_override) "toStringHX" #else "toString" #end] = function() {
var date : Date = __this__;
var m = date.getMonth() + 1;
var d = date.getDate();
var h = date.getHours();
var mi = date.getMinutes();
var s = date.getSeconds();
return date.getFullYear()
+"-"+(if( m < 10 ) "0"+m else ""+m)
+"-"+(if( d < 10 ) "0"+d else ""+d)
+" "+(if( h < 10 ) "0"+h else ""+h)
+":"+(if( mi < 10 ) "0"+mi else ""+mi)
+":"+(if( s < 10 ) "0"+s else ""+s);
};
}
#end
}