Lightning Time
⚡️
Lightning Time
The first and largest unit is called a bolt; the others are called zaps, sparks, and charges.
A typical Lightning Time string looks like 8~0~0|e, or 8~0~0 without charges.
The three major units—bolts, zaps, and sparks—are each delimited by a tilde ~. Smaller units are delimited by a single pipe |. The charge is the only named unit after the pipe, but you can go down as far as you want. For example, 8~0~0|ef4 is a valid Lightning Time string.
The super fun part: Lightning Time represents time as three colors. The respective red, green, and blue values of each color are filled in by the four time units; the rest of the values are filled in by whatever you want!
The magic of Lightning Time: represent time with not just any 3 colors, but your favorite 3 colors!
Learn more about how Lightning Time works & play with it hands-on: https://blog.purduehackers.com/posts/lightning-time
This is an npm package that allows you to use Lightning Time in your own projects.
Usage
import { LightningTime } from '@purduehackers/time'
const lt = new LightningTime()
Colors
By default, Lightning Time colors are set to the following:
bolt: (dynamic value), 161, 0
zap: 50, (dynamic value), 214
spark: 246, 133, (dynamic value)
If you want to change the static colors, you can do so by initializing a Lightning Time object like this:
const lt = new LightningTime({
staticBoltColors: [num1, num2],
staticZapColors: [num1, num2],
staticSparkColors: [num1, num2]
})
Where num1 and num2 are RGB values, from 0-255.
Example:
const lt = new LightningTime({
staticBoltColors: [120, 240],
staticZapColors: [130, 130],
staticSparkColors: [50, 206]
})
You don't have to set a custom value for every unit, though. Example:
const lt = new LightningTime({
staticSparkColors: [50, 206]
})
You can also set colors after initializing a Lightning Time object like this:
lt.setStaticColors({
staticBoltColors: [120, 240],
staticZapColors: [130, 130],
staticSparkColors: [50, 206]
})
Convert a Date to Lightning Time
lt.convertToLightning(new Date())
/*
Assumes it's currently 12:07 AM
returns {
lightningString: '0~1~3|e'
strippedCharges: '0~1~3',
colors: {
boltColor: '#01a100',
zapColor: '#3213d6',
sparkColor: '#f6853e'
}
}
*/
Get Parts
lt.getParts('8~0~0|e')
/*
returns {
bolts: '8',
zaps: '0',
sparks: '0',
charges: 'e'
}
*/
Strip Charges
lt.stripCharges('8~0~0|e')
/*
Returns '8~0~0'
*/
Convert a Lightning Time string to a traditional time string
lt.convertFromLightning('lightning time string')
Examples:
lt.convertFromLightning('8~0~0')
/*
returns {
withSeconds: '12:00:00 PM',
withoutSeconds: '12:00 PM'
}
*/
lt.convertFromLightning('8~1~a|e')
/*
returns {
withSeconds: '12:09:26 PM',
withoutSeconds: '12:09 PM'
}
*/
Get Colors for a Lightning Time string
lt.getColors('8~0~0')
/*
Assuming `lt` was initialized with default colors
returns {
boltColor: '#80a100',
zapColor: '#3200d6',
sparkColor: '#f68500'
}
*/
lt.getColors('8~1~a|e')
/*
Assuming `lt` was initialized with default colors
returns {
boltColor: '#81a100',
zapColor: '#321ad6',
sparkColor: '#f685ae'
}
*/
6 Sep 11, 2022
109 Dec 9, 2022
16 Nov 27, 2022
43 Dec 9, 2022
29 Oct 20, 2022
7 Nov 3, 2022
21 Dec 18, 2022
4.3k Jan 3, 2023
2 Oct 13, 2022
11 Dec 13, 2022
476 Jan 1, 2023
12 Jul 29, 2022
4 Sep 9, 2022
7 Sep 1, 2022
251 Dec 24, 2022
5 Oct 28, 2022
16 Dec 26, 2022
150 Dec 27, 2022
4 Apr 9, 2022