wikishia:Comments in Local Time

From wikishia

Comments in Local Time is a gadget that changes UTC-based times and dates, such as those used in signatures, to be relative to local time. It can also optionally add the day of the week and the difference between each date and the current date. The code is at comments in local time.js.

Installation

File:Localize Comments-before.png
Before Comments in Local Time is used
File:Localize Comments-after.png
After Comments in Local Time is used

To enable this gadget, go to your preferences, click on the "Gadgets" tab, and checkmark the box labeled "Change UTC-based time and date stamps, such as those used in talk page comments, to be relative to local time."

This script can also be installed by copying the code below to your custom JavaScript file:

importScript('User:Gary/comments in local time.js'); // [[User:Gary/comments in local time.js]]

Examples

00:00 1 January 2011 (UTC) is changed to 7:00 pm, 31 December 2010, Friday (1 month, 2 days ago) (UTC-5).

The date is shown in your local time, based on your computer's timezone setting. The display is highly customizable through the use of options. For instance:

00:00 1 January 2011 (UTC) can instead be changed to 19:00, December 31, 2010, (33 days ago) (UTC-5).

Dates that are either today, yesterday, or tomorrow are shown with relative dates, such as Today, 1:00 am (UTC-5).

Settings

Default settings

LocalComments = {
	dateDifference: true,
	dateFormat: 'dmy',
	timeFirst: true,
	twentyFourHours: false,
	dayOfWeek: true,
	dropDays: 0,
	dropMonths: 0
};

Custom settings

To change the default settings, copy the above code to your custom JavaScript file and change the values after the colon. The settings are explained in greater detail below. After changing the settings, force your browser to perform a full reload of a talk page to see the effect.

dateDifference
Shows the difference in terms of days, months, and years from the timestamp and today's date.
Options: true to show the difference between the timestamp and today's date, and false to hide the difference
dateFormat
Changes the date's format.
Options: 'dmy' for "1 January 2009", 'mdy' for "January 1, 2009", and 'ymd' for "2009-01-01"
timeFirst
Changes the order in which the time and date appears in timestamps.
Options: true for the time to appear before the date, and false for the date to appear before the time
twentyFourHours
Uses a 24-hour clock instead of the default 12-hour clock.
Options: false for a 12-hour clock, and true for a 24-hour clock
dayOfWeek
Displays the day of the week.
Options: true to add the day of the week, and false to suppress the day of the week
dropDays
Number of days in difference at which point only the number of months is displayed.
Options: 0 to always show the number of days, and >0 to set a maximum number of days to show
dropMonths
Number of months in difference at which point only the number of years is displayed.
Options: 0 to always show the number of months, and >0 to set a maximum number of months to show
Usage of dropDays and dropMonths
dropDays dropMonths Days difference Displayed text
0 0 75 2 months, 14 days
0 0 170 5 months, 18 days
0 0 400 1 year, 1 month, 3 days
0 0 800 2 years, 2 months, 7 days
93 0 75 75 days
93 0 170 5 months
93 0 400 1 year, 1 month
93 0 800 2 years, 2 months
0 24 75 2 months, 14 days
0 24 170 5 months, 18 days
0 24 400 13 months, 3 days
0 24 800 2 years
93 24 75 75 days
93 24 170 5 months
93 24 400 13 months
93 24 800 2 years

Settings for minimum display text

To produce the smallest display text that still includes the date difference, copy the following code to your custom JavaScript file:

LocalComments = {
	dateDifference: true,
	dateFormat: 'dmy',
	timeFirst: true,
	twentyFourHours: true,
	dayOfWeek: false,
	dropDays: 93,
	dropMonths: 24
};

To produce the absolute smallest display text, suppress the date difference entirely by copying the following code to your custom JavaScript file:

LocalComments = {
	dateDifference: false,
	dateFormat: 'dmy',
	timeFirst: true,
	twentyFourHours: true,
	dayOfWeek: false,
	dropDays: 93,
	dropMonths: 24
};

Style

To change the timestamp's style, add the code below to your monobook.css page and modify it using Cascading Style Sheets. For example, to change the timestamp's size, increase or decrease the percentage in the code accordingly, such as to 90%.

.localcomments { font-size: 100% !important; }

Local time

The script draws local time for signatures from the time set on the user's computer. The time for logs and page histories is drawn from the time set in the appearance tab in each user's preferences.

Localization

To localize this script to use a language other than English, copy the code from comments in local time.js, and follow the instructions under "LOCALIZING THIS SCRIPT" in the code.

See also