MarsDate.js

A Javascript Date object for Mars timekeeping and Earth-Mars date/time conversion.

Updates in 0.0.4

Completed setTimezone() function.
Implemented String input.
Added the placeholder N to get the ISO 8601 numeric representation of the sol of the week.
Now translation friendly.
Added minified version.
Better Documentation.

Todo

Add Date.prototype.marsDate to allow easy conversion between Date and MarsDate objects.

Usage

The MarsDate object can be used in a similar fashion to the standard Javascript Date object.

Initialisation

You may initialise a MarsDate object in one of the following ways:


//As undefined which will assume the current date and time in MTC.
var now = new MarsDate();

//With a standard Date object which will convert from a date on Earth to a Mars date.
var dateFromEarthDate = new MarsDate(new Date(1230812388499));

//With a Mars Solar Date MSD based upon the telescopic epoch of 1609.
var dateFromMSD = new MarsDate("172387.12398");

//With Mars milliseconds elapsed since Unix epoch.
var dateFromMillis = new MarsDate(1239182398766);

//With a properly formatted Mars date (year*, month*, date*, hour, minute, second, millisecond) * = required.
var dateFromParams = new MarsDate(217, 3, 14, 12, 16, 18, 261);

//Or with a properly formatted Mars date and time string
var dateFromString = "Jov Sag 12 154";
var dateTimeFromString = "Jov Sag 12 154 12:34:50";

###Usage After initialiing a MarsDate object, you can then do a variety of things with it:


//Let's set a date first - In this case, Elon Musk's birthday.
var d = new MarsDate(new Date(1971, 6, 28));

//We can now export this date in a variety of formats:
console.log(d);  //Mer Kar 25 192 14:23:45 AMT+0000 (AMT) 
console.log(d*1); //48151066900
console.log(a.toJSON()); //192-15-25T14:23:45.787A
console.log(a.toString()); //Mer Kar 25 192 14:23:45 AMT+0000 (AMT)
console.log(a.toDateString()); //Mer Kar 25 192
console.log(a.toISOString()); //192-15-25T14:23:45.787A
console.log(a.toMTCString()); //Mer, 25 Kar 192 14:23:45 AMT

###Timezones You can set your MarsDate object to one of many timezones between "-1100" to "+1200". For a full list of timezones, see: http://www.aresastro.com/2016/03/ares-time-zone-system


d.setTimezone("+1100");
console.log(d); //Jov Kar 26 192 01:23:45 AMT+1100 (CET)

Custom Formatting

There are also a variety of options for custom date formatting.


//We can also use a custom format like so:
console.log(a.formatDate("yyy mm dd HH:MM:ss")); //192 15 25 14:23:45

Custom date formats may consist of the following elements:

Mask | Description ---- | ----------- d | Sol of the month as digits; no leading zero for single-digit days. dd | Sol of the month as digits; leading zero for single-digit days. ddd | Sol of the week as a three-letter abbreviation. dddd | Sol of the week as its full name. m | Month as digits; no leading zero for single-digit months. mm | Month as digits; leading zero for single-digit months. mmm | Month as a three-letter abbreviation. mmmm | Month as its full name. y | Year as digits; no leading zero for less than four-digit years. yy | Year as last two digits; leading zero for years less than 10. yyyy | Year represented by four digits; leading zero for years less than 1000. h | Hours; no leading zero for single-digit hours (12-hour clock). hh | Hours; leading zero for single-digit hours (12-hour clock). H | Hours; no leading zero for single-digit hours (24-hour clock). HH | Hours; leading zero for single-digit hours (24-hour clock). M | Minutes; no leading zero for single-digit minutes. MM | Minutes; leading zero for single-digit minutes. N | ISO 8601 numeric representation of the sol of the week. o | AMT/MTC timezone offset, e.g. -0700 or +0300. s | Seconds; no leading zero for single-digit seconds. ss | Seconds; leading zero for single-digit seconds. l | Milliseconds; gives 3 digits. L | Milliseconds; gives 2 digits. t | Lowercase, single-character time marker string: a or p. tt | Lowercase, two-character time marker string: am or pm. T | Uppercase, single-character time marker string: A or P. TT | Uppercase, two-character time marker string: AM or PM. W | ISO 8601 week number of the year, e.g. 63 Z | Ares timezone abbreviation, e.g. AMT or COT.

Marsdatejs

Install / Use

README