A versatile Amplenote plugin that allows you to easily insert timestamps in multiple formats, including Digital, Roman Numerals, Analog (SVG clock), verbose text, and Unix time. It also features a utility to replace Unix timestamps with local date times.
- Create a Plugin Note: Create a new note in Amplenote (e.g., named "Timestamp Plugin").
- Setup Metadata Table: At the very top of the note, create a table with the following rows:
| Field | Value |
|---|---|
| name | Timestamp |
| description | Different types of Timestamps. Every possibility that you can think of. You can modify them based on your needs using the info given in the below details using the different details in the below (View note Link). |
| instructions | Start by typing forward slash command. Type Timestamp, and you will be able to see all the 5 different options, Digital, Roman, Analog, Text, Unix. To convert the Unix back to normal Timestamp, select the Unix, in the dropdown, click on UnixToDateTime. Digital Formatting Reference: https://github.com/krishnakanthb13/anp-01-timestamp/blob/main/dayjs.md |
| icon | update |
| settings | timestamp digital - format |
| settings | timestamp digital - timezone |
| settings | timestamp analog - theme |
| settings | timestamp analog - size |
| settings | timestamp analog - suffix |
| settings | timestamp text - prefix |
| settings | timestamp text - suffix |
- Insert Code Block: Below the table, create a single Javascript code block (type
```javascript). - Paste Compiled Code: Copy the content from
build/timestamp.compiled.jsand paste it inside that code block. - Activate: Go to Account Settings -> Plugins, and select the note you just created.
Once installed, the plugin adds the following commands to your note:
Trigger these by typing / or { in a note and selecting the command.
{ Digital }: Inserts a standard digital timestamp according to your configuredtimestamp digital - formatsetting. Supports Moment.js/Day.js style tokens and a special "ISO" keyword.{ Roman }: Inserts the current date and time formatted entirely in Roman numerals.{ Analog }: Inserts a visually appealing Analog clock as an image (SVG converted to PNG). The appearance can be customized via the theme and size settings.{ Text }: Inserts a verbose text representation of the current time (e.g., "It's half past Twelve").{ Unix }: Inserts the current Unix timestamp (seconds since epoch).
These commands act on selected text in your note.
UnixToDateTime: Select a Unix timestamp in your note, run this command, and it will be replaced by your local date and time string.
You can customize the plugin by modifying the values in your metadata table:
timestamp digital - format: (Default:YYYY-MM-DD HH:mm:ss) The format string for the digital clock. Supports standard day.js formatting tokens orISOfor ISO-8601 formatting.timestamp digital - timezone: (Default:local) Allows you to force the digital formatter to use UTC by setting this toUTC.timestamp analog - theme: (Default:dark) The theme for the analog clock face. Valid values aredark,light, orneon.timestamp analog - size: (Default:100) The width and height (in pixels) of the inserted analog clock image.timestamp analog - suffix: Additional text or markdown to append after the analog clock image.timestamp text - prefix: Text to prefix before the verbose text timestamp.timestamp text - suffix: Text to append after the verbose text timestamp.
This plugin is designed using a modular architecture to maintain readability and easy testing.
- The
lib/formatters/directory contains individual modules for each timestamp format type (digital.js,analog.js,roman.js,text.js,unix.js). - The
lib/replacers/directory contains logic for text transformation (unix_to_datetime.js). - The main entry file
timestamp.jsimports these modules and exposes them to the Amplenote Plugin API structure. - The project is bundled into a single file (
build/timestamp.compiled.js) usingesbuildto ensure compatibility with Amplenote's environment, wrapped in an IIFE.