Using Current Time Plugin
Using Current Time Plugin is a Plugin for the Current Time.
Parameters
format=''format string'' : How the date and time should be formatted. If you omit this, a default format will be used. The following characters are available to you:
| Symbol | Meaning | Presentation | Example | |
|---|---|---|---|---|
| G | era designator | (Text) | AD | |
| y | year | (Number) | 1996 | |
| M | month in year | (Text & Number) | July & 07 | |
| d | day in month | (Number) | 10 | |
| h | hour in am/pm (1~12) | (Number) | 12 | |
| H | hour in day (0~23) | (Number) | 0 | |
| m | minute in hour | (Number) | 30 | |
| s | second in minute | (Number) | 55 | |
| S | millisecond | (Number) | 978 | |
| E | day in week | (Text) | Tuesday | |
| D | day in year | (Number) | 189 | |
| F | day of week in month | (Number) | 2 (2nd Wed in July) | |
| w | week in year | (Number) | 27 | |
| W | week in month | (Number) | 2 | |
| a | am/pm marker | (Text) | PM | |
| k | hour in day (1~24) | (Number) | 24 | |
| K | hour in am/pm | (0~11) | (Number) | 0 |
| z | time zone | (Text) | Pacific Standard Time | |
| \' | escape for text | (Delimiter) | \\ | |
| \'' | single quote | (Literal) | ' |
For example, two 'y':s give you the year using two digits. Four 'y':s give you the year in four digits. Three 'M':s give you the month in letters, whereas two 'M':s give just the month number.
(Yes, these are exactly the Java SimpleDateFormat arguments. Sorry for copying them in.)
Example
Using [{CurrentTimePlugin format='yyyy.MM.dd G \'at\' hh:mm:ss z'}] would give you:
'2026.06.06
12:18 AM
06/06/2026, 12:18:08 AM
Features
- User preference support - Respects locale, timezone, date format, and time format from /profile
- Custom format patterns - JSPWiki-style SimpleDateFormat patterns
- Comprehensive testing - 31 tests covering all functionality
- Auto-discovery - Automatically loaded by PluginManager
Key Capabilities
- Default behavior: 06/06/2026, 12:18:08 AM uses user's profile preferences
- Custom formats: 2026-06-06 12:18:08
- Timezone-aware: Converts time to user's configured timezone
- Locale-aware: Displays month/day names in user's language
- JSPWiki compatible: Supports standard SimpleDateFormat patterns
Pagename Format Pattern Examples
- Date: yyyy-MM-dd, MM/dd/yyyy, dd/MM/yyyy
- Time: HH:mm:ss (24h), hh:mm:ss a (12h with AM/PM)
- Long form: EEEE, MMMM d, yyyy → "Sunday, October 5, 2025"
- Combined: yyyy-MM-dd HH:mm → "2025-10-05 14:30"
Unit Tests
- Tests pass, covering:
- User preferences (locale, timezone, time format)
- Custom format patterns
- Different locales (EN, FR, DE, JA, etc.)
- Different timezones (UTC, America/New_York, Asia/Tokyo)
- Edge cases and error handling
No comments yet.