path: root/html/Shift.pdf

%PDF-1.3
%����
2 0 obj
<<
/Length 4101
>>
stream
BT
/TT2 1 Tf
10 0 0 10 29 805 Tm
0 g
/GS1 gs
0 Tc
0 Tw
(SHIFT\(1\)              User Contributed Perl Documentation             SHIFT\(1\))Tj
0 -4.4 TD
(N)Tj
0 0 TD
(NA)Tj
0.6 0 TD
(AM)Tj
0.6 0 TD
(ME)Tj
0.6 0 TD
(E)Tj
-1.8 -1.1 TD
(       Image::ExifTool::Shift.pl - ExifTool time shifting routines)Tj
0 -2.2 TD
(D)Tj
0 0 TD
(DE)Tj
0.6 0 TD
(ES)Tj
0.6 0 TD
(SC)Tj
0.6 0 TD
(CR)Tj
0.6 0 TD
(RI)Tj
0.6 0 TD
(IP)Tj
0.6 0 TD
(PT)Tj
0.6 0 TD
(TI)Tj
0.6 0 TD
(IO)Tj
0.6 0 TD
(ON)Tj
0.6 0 TD
(N)Tj
-6 -1.1 TD
(       This module contains routines used by ExifTool to shift date and time)Tj
T*
(       values.)Tj
0 -2.2 TD
(M)Tj
0 0 TD
(ME)Tj
0.6 0 TD
(ET)Tj
0.6 0 TD
(TH)Tj
0.6 0 TD
(HO)Tj
0.6 0 TD
(OD)Tj
0.6 0 TD
(DS)Tj
0.6 0 TD
(S)Tj
-3.6 -1.1 TD
(   S)Tj
1.8 0 TD
(Sh)Tj
0.6 0 TD
(hi)Tj
0.6 0 TD
(if)Tj
0.6 0 TD
(ft)Tj
0.6 0 TD
(tT)Tj
0.6 0 TD
(Ti)Tj
0.6 0 TD
(im)Tj
0.6 0 TD
(me)Tj
0.6 0 TD
(e)Tj
-6.6 -1.1 TD
(       Shift date/time value)Tj
0 -2.2 TD
(           use Image::ExifTool;)Tj
0 -1.1 TD
(           $err = Image::ExifTool::ShiftTime\($dateTime, $shift\);)Tj
0 -2.2 TD
(       Inputs:)Tj
0 -1.1 TD
(           0\) Date/time string in EXIF format \(eg. "2016:01:30 11:45:00"\).)Tj
0 -2.2 TD
(           1\) Shift string \(see below\) with optional leading sign for shift)Tj
0 -1.1 TD
(           direction.)Tj
0 -2.2 TD
(           2\) [optional] Direction of shift \(-1 or +1\), or 0 or undef to use)Tj
0 -1.1 TD
(           the sign from the shift string.)Tj
0 -2.2 TD
(           3\) [optional] Reference to time-shift hash -- filled in by first)Tj
0 -1.1 TD
(           call to S)Tj
11.4 0 TD
(Sh)Tj
0.6 0 TD
(hi)Tj
0.6 0 TD
(if)Tj
0.6 0 TD
(ft)Tj
0.6 0 TD
(tT)Tj
0.6 0 TD
(Ti)Tj
0.6 0 TD
(im)Tj
0.6 0 TD
(me)Tj
0.6 0 TD
(e, and used in subsequent calls to shift date/time)Tj
-16.2 -1.1 TD
(           values by the same relative amount \(see "TRICKY" section below\).)Tj
0 -2.2 TD
(           or)Tj
T*
(           0\) Shift string \(and $_ contains the input date/time string\).)Tj
T*
(       Return value:)Tj
0 -1.1 TD
(           Error string, or undef on success and the input date/time string is)Tj
T*
(           shifted by the specified amount.)Tj
0 -2.2 TD
(S)Tj
0 0 TD
(SH)Tj
0.6 0 TD
(HI)Tj
0.6 0 TD
(IF)Tj
0.6 0 TD
(FT)Tj
0.6 0 TD
(T S)Tj
1.2 0 TD
(ST)Tj
0.6 0 TD
(TR)Tj
0.6 0 TD
(RI)Tj
0.6 0 TD
(IN)Tj
0.6 0 TD
(NG)Tj
0.6 0 TD
(G)Tj
-6.6 -1.1 TD
(       Time shifts are applied to standard EXIF-formatted date/time values)Tj
T*
(       \(eg.  "2005:03:14 18:55:00"\).  Date-only and time-only values may also)Tj
T*
(       be shifted, and an optional timezone \(eg. "-05:00"\) is also supported.)Tj
T*
(       Here are some general rules and examples to explain how shift strings)Tj
T*
(       are interpreted:)Tj
0 -2.2 TD
(       Date-only values are shifted using the following formats:)Tj
T*
(           'Y:M:D'     - shift date by 'Y' years, 'M' months and 'D' days)Tj
0 -1.1 TD
(           'M:D'       - shift months and days only)Tj
T*
(           'D'         - shift specified number of days)Tj
0 -2.2 TD
(       Time-only values are shifted using the following formats:)Tj
T*
(           'h:m:s'     - shift time by 'h' hours, 'm' minutes and 's' seconds)Tj
0 -1.1 TD
(           'h:m'       - shift hours and minutes only)Tj
T*
(           'h'         - shift specified number of hours)Tj
0 -2.2 TD
(       Timezone shifts are specified in the following formats:)Tj
T*
(           '+h:m'      - shift timezone by 'h' hours and 'm' minutes)Tj
0 -1.1 TD
(           '-h:m'      - negative shift of timezone hours and minutes)Tj
T*
(           '+h'        - shift timezone hours only)Tj
T*
(           '-h'        - negative shift of timezone hours only)Tj
0 -2.2 TD
(       A valid shift value consists of one or two arguments, separated by a)Tj
0 -1.1 TD
(       space.  If only one is provided, it is assumed to be a time shift when)Tj
T*
(       applied to a time-only or a date/time value, or a date shift when)Tj
T*
(       applied to a date-only value.  For example:)Tj
0 -2.2 TD
(           '1'         - shift by 1 hour if applied to a time or date/time)Tj
ET
endstream
endobj
3 0 obj
<<
/ProcSet [/PDF /Text ]
/Font <<
/TT2 4 0 R
>>
/ExtGState <<
/GS1 5 0 R
>>
>>
endobj
8 0 obj
<<
/Length 4479
>>
stream
BT
/TT2 1 Tf
10 0 0 10 29 805 Tm
0 g
/GS1 gs
0 Tc
0 Tw
(                         value, or by one day if applied to a date value)Tj
0 -1.1 TD
(           '2:0'       - shift 2 hours \(time, date/time\), or 2 months \(date\))Tj
T*
(           '5:0:0'     - shift 5 hours \(time, date/time\), or 5 years \(date\))Tj
T*
(           '0:0:1'     - shift 1 s \(time, date/time\), or 1 day \(date\))Tj
0 -2.2 TD
(       If two arguments are given, the date shift is first, followed by the)Tj
0 -1.1 TD
(       time shift:)Tj
0 -2.2 TD
(           '3:0:0 0'         - shift date by 3 years)Tj
0 -1.1 TD
(           '0 15:30'         - shift time by 15 hours and 30 minutes)Tj
T*
(           '1:0:0 0:0:0+5:0' - shift date by 1 year and timezone by 5 hours)Tj
0 -2.2 TD
(       A date shift is simply ignored if applied to a time value or visa)Tj
0 -1.1 TD
(       versa.)Tj
0 -2.2 TD
(       Numbers specified in shift fields may contain a decimal point:)Tj
T*
(           '1.5'       - 1 hour 30 minutes \(time, date/time\), or 1 day \(date\))Tj
0 -1.1 TD
(           '2.5 0'     - 2 days 12 hours \(date/time\), 12 hours \(time\) or)Tj
T*
(                         2 days \(date\))Tj
0 -2.2 TD
(       And to save typing, a zero is assumed for any missing numbers:)Tj
T*
(           '1::'       - shift by 1 hour \(time, date/time\) or 1 year \(date\))Tj
0 -1.1 TD
(           '26:: 0'    - shift date by 26 years)Tj
T*
(           '+:30'      - shift timezone by 30 minutes)Tj
0 -2.2 TD
(       Below are some specific examples applied to real date and/or time)Tj
0 -1.1 TD
(       values \('Dir' is the applied shift direction: '+' is positive, '-' is)Tj
T*
(       negative\):)Tj
0 -2.2 TD
(            Original Value         Shift   Dir    Shifted Value)Tj
0 -1.1 TD
(           ---------------------  -------  ---  ---------------------)Tj
T*
(           '20:30:00'             '5'       +   '01:30:00')Tj
T*
(           '2005:01:27'           '5'       +   '2005:02:01')Tj
T*
(           '2005:01:27 20:30:00'  '5'       +   '2005:01:28 01:30:00')Tj
T*
(           '11:54:00'             '2.5 0'   -   '23:54:00')Tj
T*
(           '2005:11:02'           '2.5 0'   -   '2005:10:31')Tj
T*
(           '2005:11:02 11:54:00'  '2.5 0'   -   '2005:10:30 23:54:00')Tj
T*
(           '2004:02:28 08:00:00'  '1 1.3'   +   '2004:02:29 09:18:00')Tj
T*
(           '07:00:00'             '-5'      +   '07:00:00')Tj
T*
(           '07:00:00+01:00'       '-5'      +   '07:00:00-04:00')Tj
T*
(           '07:00:00Z'            '+2:30'   -   '07:00:00-02:30')Tj
T*
(           '1970:01:01'           '35::'    +   '2005:01:01')Tj
T*
(           '2005:01:01'           '400'     +   '2006:02:05')Tj
T*
(           '10:00:00.00'          '::1.33'  -   '09:59:58.67')Tj
0 -2.2 TD
(N)Tj
0 0 TD
(NO)Tj
0.6 0 TD
(OT)Tj
0.6 0 TD
(TE)Tj
0.6 0 TD
(ES)Tj
0.6 0 TD
(S)Tj
-2.4 -1.1 TD
(       The format of the original date/time value is not changed when the time)Tj
T*
(       shift is applied.  This means that the length of the date/time string)Tj
T*
(       will not change, and only the numbers in the string will be modified.)Tj
T*
(       The only exception to this rule is that a 'Z' timezone is changed to)Tj
T*
(       '+00:00' notation if a timezone shift is applied.  A timezone will not)Tj
T*
(       be added to the date/time string.)Tj
0 -2.2 TD
(T)Tj
0 0 TD
(TR)Tj
0.6 0 TD
(RI)Tj
0.6 0 TD
(IC)Tj
0.6 0 TD
(CK)Tj
0.6 0 TD
(KY)Tj
0.6 0 TD
(Y)Tj
-3 -1.1 TD
(       This module is perhaps more complicated than it needs to be because it)Tj
T*
(       is designed to be very flexible in the way time shifts are specified)Tj
T*
(       and applied...)Tj
0 -2.2 TD
(       The ability to shift dates by Y years, M months, etc, conflicts with)Tj
0 -1.1 TD
(       the design goal of maintaining a constant shift for all time values)Tj
T*
(       when applying a batch shift.  This is because shifting by 1 month can)Tj
T*
(       be equivalent to anything from 28 to 31 days, and 1 year can be 365 or)Tj
T*
(       366 days, depending on the starting date.)Tj
0 -2.2 TD
(       The inconsistency is handled by shifting the first tag found with the)Tj
0 -1.1 TD
(       actual specified shift, then calculating the equivalent time difference)Tj
T*
(       in seconds for this shift and applying this difference to subsequent)Tj
T*
(       tags in a batch conversion.  So if it works as designed, the behaviour)Tj
T*
(       should be both intuitive and mathematically correct, and the user)Tj
ET
endstream
endobj
9 0 obj
<<
/ProcSet [/PDF /Text ]
/Font <<
/TT2 4 0 R
>>
/ExtGState <<
/GS1 5 0 R
>>
>>
endobj
11 0 obj
<<
/Length 1286
>>
stream
BT
/TT2 1 Tf
10 0 0 10 29 805 Tm
0 g
/GS1 gs
0 Tc
0 Tw
(       shouldn't have to worry about details such as this \(in keeping with)Tj
0 -1.1 TD
(       Perl's "do the right thing" philosophy\).)Tj
0 -2.2 TD
(B)Tj
0 0 TD
(BU)Tj
0.6 0 TD
(UG)Tj
0.6 0 TD
(GS)Tj
0.6 0 TD
(S)Tj
-1.8 -1.1 TD
(       Due to the use of the standard time library functions, dates are)Tj
T*
(       typically limited to the range 1970 to 2038 on 32-bit systems.)Tj
0 -2.2 TD
(A)Tj
0 0 TD
(AU)Tj
0.6 0 TD
(UT)Tj
0.6 0 TD
(TH)Tj
0.6 0 TD
(HO)Tj
0.6 0 TD
(OR)Tj
0.6 0 TD
(R)Tj
-3 -1.1 TD
(       Copyright 2003-2024, Phil Harvey \(philharvey66 at gmail.com\))Tj
0 -2.2 TD
(       This library is free software; you can redistribute it and/or modify it)Tj
0 -1.1 TD
(       under the same terms as Perl itself.)Tj
0 -2.2 TD
(S)Tj
0 0 TD
(SE)Tj
0.6 0 TD
(EE)Tj
0.6 0 TD
(E A)Tj
1.2 0 TD
(AL)Tj
0.6 0 TD
(LS)Tj
0.6 0 TD
(SO)Tj
0.6 0 TD
(O)Tj
-4.2 -1.1 TD
(       _)Tj
4.2 0 TD
(I_)Tj
0.6 0 TD
(m_)Tj
0.6 0 TD
(a_)Tj
0.6 0 TD
(g_)Tj
0.6 0 TD
(e_)Tj
0.6 0 TD
(:_)Tj
0.6 0 TD
(:_)Tj
0.6 0 TD
(E_)Tj
0.6 0 TD
(x_)Tj
0.6 0 TD
(i_)Tj
0.6 0 TD
(f_)Tj
0.6 0 TD
(T_)Tj
0.6 0 TD
(o_)Tj
0.6 0 TD
(o_)Tj
0.6 0 TD
(l\(3pm\))Tj
-12.6 -4.4 TD
(perl v5.18.4                      2024-01-22                          SHIFT\(1\))Tj
ET
endstream
endobj
12 0 obj
<<
/ProcSet [/PDF /Text ]
/Font <<
/TT2 4 0 R
>>
/ExtGState <<
/GS1 5 0 R
>>
>>
endobj
5 0 obj
<<
/Type /ExtGState
/SA false
/SM 0.02
/OP false
/op false
/OPM 1
/BG2 /Default
/UCR2 /Default
/HT /Default
/TR2 /Default
>>
endobj
13 0 obj
<<
/Type /FontDescriptor
/Ascent 753
/CapHeight 562
/Descent -246
/Flags 35
/FontBBox [-28 -250 628 805]
/FontName /Courier
/ItalicAngle 0
/StemV 51
/XHeight 426
/StemH 51
>>
endobj
4 0 obj
<<
/Type /Font
/Subtype /TrueType
/FirstChar 32
/LastChar 146
/Widths [600 0 600 0 600 0 0 600 600 600 0 600 600 600 600 600
600 600 600 600 600 600 600 600 600 600 600 600 0 600 0 0
0 600 600 600 600 600 600 600 600 600 0 600 600 600 600 600
600 0 600 600 600 600 600 0 600 600 600 600 0 600 0 600
600 600 600 600 600 600 600 600 600 600 0 600 600 600 600 600 
600 600 600 600 600 600 600 600 600 600 600 0 0 0 0 0 
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 
0 0 600 ]
/Encoding /WinAnsiEncoding
/BaseFont /Courier
/FontDescriptor 13 0 R
>>
endobj
1 0 obj
<<
/Type /Page
/Parent 6 0 R
/Resources 3 0 R
/Contents 2 0 R
>>
endobj
7 0 obj
<<
/Type /Page
/Parent 6 0 R
/Resources 9 0 R
/Contents 8 0 R
>>
endobj
10 0 obj
<<
/Type /Page
/Parent 6 0 R
/Resources 12 0 R
/Contents 11 0 R
>>
endobj
14 0 obj
<<
/S /D
>>
endobj
15 0 obj
<<
/Nums [0 14 0 R ]
>>
endobj
6 0 obj
<<
/Type /Pages
/Kids [1 0 R 7 0 R 10 0 R]
/Count 3
/MediaBox [0 0 595 842]
>>
endobj
16 0 obj
<<
/CreationDate (D:20240123091136-05'00')
/ModDate (D:20240123091136-05'00')
/Producer (Apple pstopdf)
>>
endobj
17 0 obj
<<
/Type /Catalog
/Pages 6 0 R
/PageLabels 15 0 R
>>
endobj
xref
0 18
0000000000 65535 f 
0000011203 00000 n 
0000000016 00000 n 
0000004169 00000 n 
0000010656 00000 n 
0000010325 00000 n 
0000011514 00000 n 
0000011283 00000 n 
0000004264 00000 n 
0000008795 00000 n 
0000011363 00000 n 
0000008890 00000 n 
0000010229 00000 n 
0000010465 00000 n 
0000011446 00000 n 
0000011474 00000 n 
0000011608 00000 n 
0000011731 00000 n 
trailer
<<
/Size 18
/Root 17 0 R
/Info 16 0 R
/ID [<c210869b445d50135836b61f215929db><c210869b445d50135836b61f215929db>]
>>
startxref
11800
%%EOF