construct/modules/static/js/datetime.js

/*
// Matrix Construct
//
// Copyright (C) Matrix Construct Developers, Authors & Contributors
// Copyright (C) 2016-2018 Jason Volk <jason@zemos.net>
//
// Permission to use, copy, modify, and/or distribute this software for any
// purpose with or without fee is hereby granted, provided that the above
// copyright notice and this permission notice is present in all copies. The
// full license for this software is available in the LICENSE file.
*/

'use strict';

/**************************************
 *
 * Space & Time
 *
 */

/**
 * Date & time tools
 */
mc.date =
{
	now: () =>
		new Date().getTime(),

	unix: () =>
		mc.date.now() / 1000.0,

	ago: (epoch) =>
		mc.date.now() - epoch,
};

// Alias
mc.now = () =>
	mc.date.now();

// UTC suite
mc.date.utc =
{
	pretty: (epoch) =>
		new Date(epoch).toUTCString(),
}

// Locale suite
mc.date.local =
{
	pretty: (epoch) =>
		new Date(epoch).toLocaleString(),
};

// High resolution suite
mc.date.perf =
{
	now: () =>
		window.performance.now(),
};

// Convert numerical information into an english description
mc.date.describe = {};

/**
 * Describe a "time ago" for a past epoch in ms
 */
mc.date.describe.since = (ts, short = false) =>
{
	let elapsed = mc.date.now() - ts;
	return mc.date.describe.elapsed(elapsed, short);
}

/**
 * Describe a "time ago" from a milliseconds param
 */
mc.date.describe.elapsed = (ms, short = false) =>
{
	if(typeof(ms) != "number")
		return "";

	if(ms < 0)
		return "now";

	let order =
	{
		//Year:    (ms / (1000 * 60 * 60 * 24 * 7 * 4 * 12)),
		Month:   (ms / (1000 * 60 * 60 * 24 * 7 * 4)),
		Week:    (ms / (1000 * 60 * 60 * 24 * 7)),
		Day:     (ms / (1000 * 60 * 60 * 24)),
		hour:    (ms / (1000 * 60 * 60)),
		minute:  (ms / (1000 * 60)),
		second:  (ms / (1000)),
	};

	for(let key in order)
	{
		let val = parseInt(order[key]);
		if(val <= 0.0001)
			continue;

		let unit = short? key[0] : " " + key;
		if(!short && val > 1)
			unit += 's';

		return "" + val + "" + unit;
	}

	return short? (ms + "ms") : "less than a second";
};

/**
 * Space / bytes tools
 */
mc.space = {};
mc.space.describe = {};

mc.space.describe.bytes = (bytes) =>
{
	if(typeof(bytes) != "number")
		return "";

	let order =
	{
		TiB: (bytes / (1024 * 1024 * 1024 * 1024)),
		GiB: (bytes / (1024 * 1024 * 1024)),
		MiB: (bytes / (1024 * 1024)),
		KiB: (bytes / (1024)),
		B: bytes,
	};

	for(let key in order)
	{
		let val = order[key];
		if(val >= 1.0)
			return "" + val.toFixed(2) + " " + key;
	}

	return "" + bytes + " Bytes";
};