Matt Gifford aka coldfumonkeh | Consultant Developer
View Github Profile


Permatime API ColdFusion CFC Wrapper

Aug 24, 2010

A few days ago I was made aware of the great little site permatime.com

What Time Is It?

A fantastic mini-app, this site is ideal for online meetings or perhaps events that require attendees from across the globe.

By setting the timezone for the event as part of the link, any users following that URL will see the details of the event/party/conference etc in their own local time zone.

Oooh, an API

To my delight, the permatime team had documented every parameter needed to generate a permatime URL, thereby letting users generate the links off site.

Of course, not wanting to miss an opportunity, I wanted to have some fun and create a ColdFusion wrapper for this service, which is available to download now from riaforge and is incredibly easy to use indeed.

<cfscript>
	// instantiate the permatime component
	objPermatime = createObject('component',
				'com.coldfumonkeh.permatime.permatime')
				.init();

	/* For a list of available location/timezones,
		please visit http://permatime.com/timezones
	*/

	strPermLink = objPermatime.buildLink(
			location 	= 'Europe/England',
			date		= '2010-08-27',
			time		= '14:00',
			label		= '80sFriday',
			link		= 'http://www.monkehradio.com/'
		);
</cfscript>

It really is that easy to use the wrapper, and the resulting value of the strPermLink variable will be the generated link to the permatime site, which in this case would be:

http://permatime.com/Europe/England/2010-08-27/14:00/80sFriday?link=http://www.monkehradio.com/

Following that permatime link, you would be greeted with the following information, which you could then email on or alter the time zones.

permatimeExample

The wrapper also contains a second function which enables you to generate a permatime link using a unix time stamp, like so:

<cfscript>
	strPermLink2 = objPermatime.buildTimestampLink(
			timestamp 	= '1226183760'
			/*
			* This function can also accept a label and link attribute
			*/
		);
</cfscript>

I can see this service with so many uses; implementations into CMS or diary / event applications to name a few.

And of course, if you needed to shrink the links after generation, you could always pass them through my bit.ly API CFC Wrapper :) *cross promotion is always a good thing*

Where can I get it?

The code is available to download from RIAforge.org, here: http://permatime.riaforge.org/


Latest Blog Posts

Nov 13, 2019
CFML swearjar profanity detection and filtering component library
Read More
Oct 25, 2019
Lucee 5 _InternalRequest method
Read More