bugGNU Octave - Bugs: bug #53916, Document the TZ environment...

 
 

bug #53916: Document the TZ environment variable

Submitter:  Ian McCallion <ianmcc>
Submitted:  Tue 15 May 2018 08:05:01 PM UTC
   
 
Category:  Documentation Severity:  3 - Normal
Priority:  5 - Normal Item Group:  Documentation
Status:  None Assigned to:  None
Originator Name:  Open/Closed:  * Open
Release:  * 4.4.0 Operating System:  * Any
Fixed Release:  None Planned Release:  None
* Mandatory Fields

Add a New Comment Rich Markup
   

Mon 09 Jan 2023 05:08:17 AM UTC, comment #1: 

tz problem change




Thanks for taking the time to report this bug.

Without a stack trace from the crash it's very hard to determine
what caused it. Can you get us a stack trace? Please see
http://wiki.octave.org/Debugging_Octave for more information on
how to do so. Thanks in advance!

Anonymous
Tue 15 May 2018 08:05:01 PM UTC, original submission:  

Section 36.1 of the Octave manual should describe the TZ environment variable. I suggest something like the following:

The TZ environment variable can be used within a process to override the system's timezone. Octave functions such as localtime that return the dates and times in local time use the timezone specified in the TZ environment variable. Specification of TZ can be found here:  https://www.gnu.org/software/libc/manual/html_node/TZ-Variable.html#TZ-Variable.

Functions affected
------------------
localtime, mktime and lstat functions (and possibly others??) are affected by the TZ environment variable.

Note that the Octave interpreter and GUI are not affected by the TZ variable. Time and date are not directly displayed, except by scripts and where dates and times are used internally for example in timestamp comparisons UTC is used.

Windows/Unix differences
------------------------

The TZ feature IS NOT present in Microsoft Windows, and the posix layer shipped with Octave for Microsoft Windows only partially emulates TZ, for example on Windows calls to the underlying operating system that display local times eg system('dir'), these do not return times in the TZ-specified the timezone whereas (I assume??) the equivalents on unix do. This is unlikely to be a problem in practice.







Ian McCallion <ianmcc>

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:
   
   
Comment:
   

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -email is unavailable- added by ianmcc (Submitted the item)
  •  

    There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.

    Only group members can vote.

     

    No changes have been made to this item

    Back to the top

    Powered by Savane 3.13-4448.
    Corresponding source code