From wiki.ginstr.com
Jump to: navigation, search
 
(5 intermediate revisions by 3 users not shown)
Line 3: Line 3:
 
[[Category:Action_Library]]
 
[[Category:Action_Library]]
  
;Description: Action used to convert timestamp (numerical value) from certain widget to human readable format.
+
;Description: Action used to convert timestamp (numerical value) from certain widget to human readable format. Action by default formats time in relation to local timezone of user.
  
 
;Action returns: void
 
;Action returns: void
Line 10: Line 10:
 
===Convert timestamp from certain widget===
 
===Convert timestamp from certain widget===
  
;<code>[gn:act_convertTimestampToFormat]|[source,target,format]</code>
+
:;<code>[gn:act_convertTimestampToFormat]|[source,target,format]</code>
  
{| class="wikitable sortable" style="font-size: 85%; text-align: left;"
+
with timezone
 +
 
 +
:;<code>[gn:act_convertTimestampToFormat]|[source,target,format,manualTimeZone]</code>
 +
 
 +
:{| class="wikitable sortable" style="font-size: 85%; text-align: left;"
 
|-
 
|-
 
! scope="col" | Parameter
 
! scope="col" | Parameter
 
! scope="col" | Description
 
! scope="col" | Description
 
|-
 
|-
| [[source]]
+
| <code>[[source]]</code>
 
| [[source]] from where value for conversion will be retrieved
 
| [[source]] from where value for conversion will be retrieved
 
* Valid [[source|sources]]:
 
* Valid [[source|sources]]:
**[[DtText]]
+
**<code>[[Datatypes#text|text]]</code>
**[[Datatypes#date|date]]
+
**<code>[[Datatypes#date|date]]</code>
**[[Datatypes#dateTime|dateTime]]
+
**<code>[[Datatypes#dateTime|dateTime]]</code>
**[[Datatypes#time|time]]
+
**<code>[[Datatypes#time|time]]</code>
 +
**<code>[[Datatypes#number|number]]</code>
 
|-
 
|-
| [[target]]
+
| <code>[[target]]</code>
 
| [[target]] from where the while action is using value as expression comparsion parameter
 
| [[target]] from where the while action is using value as expression comparsion parameter
 
* Valid [[target|targets]]:
 
* Valid [[target|targets]]:
** [[DtText]]
+
** <code>[[Datatypes#text|text]]</code>
 
|-
 
|-
| format
+
| <code>format</code>
 
| format in which [[source]] value will be converted
 
| format in which [[source]] value will be converted
 
* Valid formats:
 
* Valid formats:
 
**[http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html formats]
 
**[http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html formats]
 +
|-
 +
| <code>manualTimeZone</code>
 +
| timeZone in which timestamp will be shown. By default it's local timezone. If <code>DATE</code> datatype is used then default timezone is <code>GMT</code>. Valid timezones:
 +
[https://docs.oracle.com/javase/7/docs/api/java/util/TimeZone.html timezone construct]
 +
* Valid [[target|targets]]:
 +
** <code>[[Datatypes#text|text]]</code>
 
|-
 
|-
 
|}
 
|}
  
 
====Example====
 
====Example====
<code>@+id/timeInDATA</code> - [[source]]<br>  
+
:<code>@+id/timeInDATA</code> - [[source]]<br>  
<code>@+id/clockTimeIn</code> - [[target]]<br>
+
:<code>@+id/clockTimeIn</code> - [[target]]<br>
<code>@string/screen3_timeFormat</code> - format e.g. <code>dd.MM.yyyy H:mm:ss</code><br><br>
+
:<code>@string/screen3_timeFormat</code> - format e.g. <code>dd.MM.yyyy H:mm:ss</code><br>
<code>[gn:act_convertTimestampToFormat]|[@+id/timeInDATA,@+id/clockTimeIn,@string/screen3_timeFormat]</code>
+
:; ⤷ <code>[gn:act_convertTimestampToFormat]|[@+id/timeInDATA,@+id/clockTimeIn,@string/screen3_timeFormat]</code>
 
<hr>
 
<hr>

Latest revision as of 13:27, 4 November 2020

gn:act_convertTimestampToFormat

Description
Action used to convert timestamp (numerical value) from certain widget to human readable format. Action by default formats time in relation to local timezone of user.
Action returns
void

Action signatures

Convert timestamp from certain widget

[gn:act_convertTimestampToFormat]|[source,target,format]

with timezone

[gn:act_convertTimestampToFormat]|[source,target,format,manualTimeZone]
Parameter Description
source source from where value for conversion will be retrieved
target target from where the while action is using value as expression comparsion parameter
format format in which source value will be converted
manualTimeZone timeZone in which timestamp will be shown. By default it's local timezone. If DATE datatype is used then default timezone is GMT. Valid timezones:

timezone construct

Example

@+id/timeInDATA - source
@+id/clockTimeIn - target
@string/screen3_timeFormat - format e.g. dd.MM.yyyy H:mm:ss
[gn:act_convertTimestampToFormat]|[@+id/timeInDATA,@+id/clockTimeIn,@string/screen3_timeFormat]