Differences

This shows you the differences between two versions of the page.

--- en:user:gs3_list_of_format_options [2019/10/21 21:18] – [Miscellaneous Things] kjdon
+++ en:user:gs3_list_of_format_options [2019/10/21 21:41] – [Additional Notes] kjdon
@@ Line 246: / Line 246: @@
 |lang|language code|Defines the language whose sorting conventions are to be used|
 |data-type|text/number/data-type name|Defines whether values are sorted alphabetically, numerically, or using a user-defined data type|
+==== Utility Functions ====
+There are many utility functions defined in src/java/org/greenstone/gsdl3/util/XSLTUtil.java. Some of these are used behind the scenes, as part of gsf elements. For example, ....
+They can be called explicitly using
+<code>
+<xsl:value of select="util:fname(args)"/>
+</code>
+args is a comma separated list of args. They can be XSLT variables, numbers, strings, XSLT elements/attributes.
+For example:
+<code>
+   <xsl:variable name="raw_date"><gslib:collectionMeta name="buildDate"/></xsl:variable>
+   The collection was last built on <xsl:value-of select="util:formatTimeStamp($raw_date, 0, 0, /page/@lang)"/>
+</code>
+This code is getting the buildDate timestamp from collection metadata. Then it is formatting it using the formatTimeStamp function.
+This function takes 4 arguments:
+  * the timestamp - here we use the raw_date variable we have just made
+  * an integer for timestamp type - 0 is seconds, 1 is milliseconds
+  * an integer for output format tupe - 0 is date, 1 is time, 2 is date and time, 3 is days ago
+  * the language code for which language you want the output in - here we use the attribute from the page element.
+We could change this output to days ago:
+The collection was last built <xsl:value-of select="util:formatTimeStamp($raw_date, 0, 3, /page/@lang)"/> days ago.
 ==== Additional Notes ====
 Some of these options (<gsf:html>; using <gsf:metadata> inside the parameters for a search link) are not available in the 3.07 release. If you are using 3.07, you can download an updated config_format.xsl file. Rename your current greenstone3/web/interfaces/default/transform/config_format.xsl (so that you can put it back if something goes wrong), and copy this one into its place.