blob: c6db071dcc6154f98c22c8e5d874b0c171bc042f (plain)

ofs	hex dump	ascii
0000	a7 0d 0d 0a 00 00 00 00 17 8a 0c 66 ad 07 00 00 e3 00 00 00 00 00 00 00 00 00 00 00 00 02 00 00	...........f....................
0020	00 00 00 00 00 f3 3a 00 00 00 97 00 64 00 5a 00 64 01 64 02 6c 01 6d 02 5a 02 01 00 64 01 64 03	......:.....d.Z.d.d.l.m.Z...d.d.
0040	6c 03 6d 03 5a 03 6d 04 5a 04 01 00 64 08 64 05 84 01 5a 05 64 06 84 00 5a 06 64 07 84 00 5a 07	l.m.Z.m.Z...d.d...Z.d...Z.d...Z.
0060	64 04 53 00 29 09 7a 73 0a 54 68 69 73 20 6d 6f 64 75 6c 65 20 6f 66 66 65 72 73 20 67 65 6e 65	d.S.).zs.This.module.offers.gene
0080	72 61 6c 20 63 6f 6e 76 65 6e 69 65 6e 63 65 20 61 6e 64 20 75 74 69 6c 69 74 79 20 66 75 6e 63	ral.convenience.and.utility.func
00a0	74 69 6f 6e 73 20 66 6f 72 20 64 65 61 6c 69 6e 67 20 77 69 74 68 0a 64 61 74 65 74 69 6d 65 73	tions.for.dealing.with.datetimes
00c0	2e 0a 0a 2e 2e 20 76 65 72 73 69 6f 6e 61 64 64 65 64 3a 3a 20 32 2e 37 2e 30 0a e9 00 00 00 00	......versionadded::.2.7.0......
00e0	29 01 da 10 75 6e 69 63 6f 64 65 5f 6c 69 74 65 72 61 6c 73 29 02 da 08 64 61 74 65 74 69 6d 65	)...unicode_literals)...datetime
0100	da 04 74 69 6d 65 4e 63 01 00 00 00 00 00 00 00 00 00 00 00 07 00 00 00 03 00 00 00 f3 96 00 00	..timeNc........................
0120	00 97 00 74 01 00 00 00 00 00 00 00 00 00 00 6a 01 00 00 00 00 00 00 00 00 7c 00 a6 01 00 00 ab	...t...........j.........|......
0140	01 00 00 00 00 00 00 00 00 7d 01 74 01 00 00 00 00 00 00 00 00 00 00 6a 02 00 00 00 00 00 00 00	.........}.t...........j........
0160	00 7c 01 a0 03 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 a6 00 00 00 ab 00 00	.|..............................
0180	00 00 00 00 00 00 00 74 09 00 00 00 00 00 00 00 00 00 00 64 01 7c 00 ac 02 a6 02 00 00 ab 02 00	.......t...........d.|..........
01a0	00 00 00 00 00 00 00 a6 02 00 00 ab 02 00 00 00 00 00 00 00 00 53 00 29 03 61 1e 01 00 00 0a 20	.....................S.).a......
01c0	20 20 20 52 65 74 75 72 6e 73 20 61 20 3a 70 79 3a 63 6c 61 73 73 3a 60 64 61 74 65 74 69 6d 65	...Returns.a.:py:class:`datetime
01e0	60 20 72 65 70 72 65 73 65 6e 74 69 6e 67 20 74 68 65 20 63 75 72 72 65 6e 74 20 64 61 79 20 61	`.representing.the.current.day.a
0200	74 20 6d 69 64 6e 69 67 68 74 0a 0a 20 20 20 20 3a 70 61 72 61 6d 20 74 7a 69 6e 66 6f 3a 0a 20	t.midnight......:param.tzinfo:..
0220	20 20 20 20 20 20 20 54 68 65 20 74 69 6d 65 20 7a 6f 6e 65 20 74 6f 20 61 74 74 61 63 68 20 28	.......The.time.zone.to.attach.(
0240	61 6c 73 6f 20 75 73 65 64 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 74 68 65 20 63 75 72 72 65	also.used.to.determine.the.curre
0260	6e 74 20 64 61 79 29 2e 0a 0a 20 20 20 20 3a 72 65 74 75 72 6e 3a 0a 20 20 20 20 20 20 20 20 41	nt.day).......:return:.........A
0280	20 3a 70 79 3a 63 6c 61 73 73 3a 60 64 61 74 65 74 69 6d 65 2e 64 61 74 65 74 69 6d 65 60 20 6f	.:py:class:`datetime.datetime`.o
02a0	62 6a 65 63 74 20 72 65 70 72 65 73 65 6e 74 69 6e 67 20 74 68 65 20 63 75 72 72 65 6e 74 20 64	bject.representing.the.current.d
02c0	61 79 0a 20 20 20 20 20 20 20 20 61 74 20 6d 69 64 6e 69 67 68 74 2e 0a 20 20 20 20 72 02 00 00	ay.........at.midnight......r...
02e0	00 a9 01 da 06 74 7a 69 6e 66 6f 29 05 72 04 00 00 00 da 03 6e 6f 77 da 07 63 6f 6d 62 69 6e 65	.....tzinfo).r......now..combine
0300	da 04 64 61 74 65 72 05 00 00 00 29 02 72 08 00 00 00 da 02 64 74 73 02 00 00 00 20 20 fa 50 2f	..dater....).r......dts.......P/
0320	68 6f 6d 65 2f 73 79 2f 63 6f 64 65 2f 73 69 74 65 2f 73 79 6d 70 6f 73 69 75 6d 2f 76 65 6e 76	home/sy/code/site/symposium/venv
0340	2f 6c 69 62 2f 70 79 74 68 6f 6e 33 2e 31 31 2f 73 69 74 65 2d 70 61 63 6b 61 67 65 73 2f 64 61	/lib/python3.11/site-packages/da
0360	74 65 75 74 69 6c 2f 75 74 69 6c 73 2e 70 79 da 05 74 6f 64 61 79 72 0e 00 00 00 0d 00 00 00 73	teutil/utils.py..todayr........s
0380	3b 00 00 00 80 00 f5 18 00 0a 12 8c 1c 90 66 d1 09 1d d4 09 1d 80 42 dd 0b 13 d4 0b 1b 98 42 9f	;.............f.......B.......B.
03a0	47 9a 47 99 49 9c 49 a5 74 a8 41 b0 66 d0 27 3d d1 27 3d d4 27 3d d1 0b 3e d4 0b 3e d0 04 3e f3	G.G.I.I.t.A.f.'=.'=.'=..>..>..>.
03c0	00 00 00 00 63 02 00 00 00 00 00 00 00 00 00 00 00 03 00 00 00 03 00 00 00 f3 40 00 00 00 97 00	....c.....................@.....
03e0	7c 00 6a 00 00 00 00 00 00 00 00 00 81 02 7c 00 53 00 7c 00 a0 01 00 00 00 00 00 00 00 00 00 00	|.j...........|.S.|.............
0400	00 00 00 00 00 00 00 00 00 00 7c 01 ac 02 a6 01 00 00 ab 01 00 00 00 00 00 00 00 00 53 00 29 03	..........|.................S.).
0420	61 a4 03 00 00 0a 20 20 20 20 53 65 74 73 20 74 68 65 20 60 60 74 7a 69 6e 66 6f 60 60 20 70 61	a.........Sets.the.``tzinfo``.pa
0440	72 61 6d 65 74 65 72 20 6f 6e 20 6e 61 69 76 65 20 64 61 74 65 74 69 6d 65 73 20 6f 6e 6c 79 0a	rameter.on.naive.datetimes.only.
0460	0a 20 20 20 20 54 68 69 73 20 69 73 20 75 73 65 66 75 6c 20 66 6f 72 20 65 78 61 6d 70 6c 65 20	.....This.is.useful.for.example.
0480	77 68 65 6e 20 79 6f 75 20 61 72 65 20 70 72 6f 76 69 64 65 64 20 61 20 64 61 74 65 74 69 6d 65	when.you.are.provided.a.datetime
04a0	20 74 68 61 74 20 6d 61 79 20 68 61 76 65 0a 20 20 20 20 65 69 74 68 65 72 20 61 6e 20 69 6d 70	.that.may.have.....either.an.imp
04c0	6c 69 63 69 74 20 6f 72 20 65 78 70 6c 69 63 69 74 20 74 69 6d 65 20 7a 6f 6e 65 2c 20 73 75 63	licit.or.explicit.time.zone,.suc
04e0	68 20 61 73 20 77 68 65 6e 20 70 61 72 73 69 6e 67 20 61 20 74 69 6d 65 20 7a 6f 6e 65 0a 20 20	h.as.when.parsing.a.time.zone...
0500	20 20 73 74 72 69 6e 67 2e 0a 0a 20 20 20 20 2e 2e 20 64 6f 63 74 65 73 74 3a 3a 0a 0a 20 20 20	..string..........doctest::.....
0520	20 20 20 20 20 3e 3e 3e 20 66 72 6f 6d 20 64 61 74 65 75 74 69 6c 2e 74 7a 20 69 6d 70 6f 72 74	.....>>>.from.dateutil.tz.import
0540	20 74 7a 6f 66 66 73 65 74 0a 20 20 20 20 20 20 20 20 3e 3e 3e 20 66 72 6f 6d 20 64 61 74 65 75	.tzoffset.........>>>.from.dateu
0560	74 69 6c 2e 70 61 72 73 65 72 20 69 6d 70 6f 72 74 20 70 61 72 73 65 0a 20 20 20 20 20 20 20 20	til.parser.import.parse.........
0580	3e 3e 3e 20 66 72 6f 6d 20 64 61 74 65 75 74 69 6c 2e 75 74 69 6c 73 20 69 6d 70 6f 72 74 20 64	>>>.from.dateutil.utils.import.d
05a0	65 66 61 75 6c 74 5f 74 7a 69 6e 66 6f 0a 20 20 20 20 20 20 20 20 3e 3e 3e 20 64 66 6c 74 5f 74	efault_tzinfo.........>>>.dflt_t
05c0	7a 20 3d 20 74 7a 6f 66 66 73 65 74 28 22 45 53 54 22 2c 20 2d 31 38 30 30 30 29 0a 20 20 20 20	z.=.tzoffset("EST",.-18000).....
05e0	20 20 20 20 3e 3e 3e 20 70 72 69 6e 74 28 64 65 66 61 75 6c 74 5f 74 7a 69 6e 66 6f 28 70 61 72	....>>>.print(default_tzinfo(par
0600	73 65 28 27 32 30 31 34 2d 30 31 2d 30 31 20 31 32 3a 33 30 20 55 54 43 27 29 2c 20 64 66 6c 74	se('2014-01-01.12:30.UTC'),.dflt
0620	5f 74 7a 29 29 0a 20 20 20 20 20 20 20 20 32 30 31 34 2d 30 31 2d 30 31 20 31 32 3a 33 30 3a 30	_tz)).........2014-01-01.12:30:0
0640	30 2b 30 30 3a 30 30 0a 20 20 20 20 20 20 20 20 3e 3e 3e 20 70 72 69 6e 74 28 64 65 66 61 75 6c	0+00:00.........>>>.print(defaul
0660	74 5f 74 7a 69 6e 66 6f 28 70 61 72 73 65 28 27 32 30 31 34 2d 30 31 2d 30 31 20 31 32 3a 33 30	t_tzinfo(parse('2014-01-01.12:30
0680	27 29 2c 20 64 66 6c 74 5f 74 7a 29 29 0a 20 20 20 20 20 20 20 20 32 30 31 34 2d 30 31 2d 30 31	'),.dflt_tz)).........2014-01-01
06a0	20 31 32 3a 33 30 3a 30 30 2d 30 35 3a 30 30 0a 0a 20 20 20 20 3a 70 61 72 61 6d 20 64 74 3a 0a	.12:30:00-05:00......:param.dt:.
06c0	20 20 20 20 20 20 20 20 54 68 65 20 64 61 74 65 74 69 6d 65 20 6f 6e 20 77 68 69 63 68 20 74 6f	........The.datetime.on.which.to
06e0	20 72 65 70 6c 61 63 65 20 74 68 65 20 74 69 6d 65 20 7a 6f 6e 65 0a 0a 20 20 20 20 3a 70 61 72	.replace.the.time.zone......:par
0700	61 6d 20 74 7a 69 6e 66 6f 3a 0a 20 20 20 20 20 20 20 20 54 68 65 20 3a 70 79 3a 63 6c 61 73 73	am.tzinfo:.........The.:py:class
0720	3a 60 64 61 74 65 74 69 6d 65 2e 74 7a 69 6e 66 6f 60 20 73 75 62 63 6c 61 73 73 20 69 6e 73 74	:`datetime.tzinfo`.subclass.inst
0740	61 6e 63 65 20 74 6f 20 61 73 73 69 67 6e 20 74 6f 0a 20 20 20 20 20 20 20 20 60 60 64 74 60 60	ance.to.assign.to.........``dt``
0760	20 69 66 20 28 61 6e 64 20 6f 6e 6c 79 20 69 66 29 20 69 74 20 69 73 20 6e 61 69 76 65 2e 0a 0a	.if.(and.only.if).it.is.naive...
0780	20 20 20 20 3a 72 65 74 75 72 6e 3a 0a 20 20 20 20 20 20 20 20 52 65 74 75 72 6e 73 20 61 6e 20	....:return:.........Returns.an.
07a0	61 77 61 72 65 20 3a 70 79 3a 63 6c 61 73 73 3a 60 64 61 74 65 74 69 6d 65 2e 64 61 74 65 74 69	aware.:py:class:`datetime.dateti
07c0	6d 65 60 2e 0a 20 20 20 20 4e 72 07 00 00 00 29 02 72 08 00 00 00 da 07 72 65 70 6c 61 63 65 29	me`......Nr....).r......replace)
07e0	02 72 0c 00 00 00 72 08 00 00 00 73 02 00 00 00 20 20 72 0d 00 00 00 da 0e 64 65 66 61 75 6c 74	.r....r....s......r......default
0800	5f 74 7a 69 6e 66 6f 72 12 00 00 00 1d 00 00 00 73 25 00 00 00 80 00 f0 3a 00 08 0a 84 79 d0 07	_tzinfor........s%......:....y..
0820	1c d8 0f 11 88 09 e0 0f 11 8f 7a 8a 7a a0 16 88 7a d1 0f 28 d4 0f 28 d0 08 28 72 0f 00 00 00 63	..........z.z...z..(..(..(r....c
0840	03 00 00 00 00 00 00 00 00 00 00 00 03 00 00 00 03 00 00 00 f3 4c 00 00 00 97 00 74 01 00 00 00	.....................L.....t....
0860	00 00 00 00 00 00 00 7c 02 a6 01 00 00 ab 01 00 00 00 00 00 00 00 00 7d 02 7c 00 7c 01 7a 0a 00	.......|...............}.|.|.z..
0880	00 7d 03 7c 02 0b 00 7c 03 63 02 78 02 6b 01 00 00 00 00 6f 05 7c 02 6b 01 00 00 00 00 6e 02 63	.}.|...|.c.x.k.....o.|.k.....n.c
08a0	02 01 00 53 00 29 01 7a 6e 0a 20 20 20 20 55 73 65 66 75 6c 20 66 6f 72 20 63 6f 6d 70 61 72 69	...S.).zn.....Useful.for.compari
08c0	6e 67 20 74 77 6f 20 64 61 74 65 74 69 6d 65 73 20 74 68 61 74 20 6d 61 79 20 68 61 76 65 20 61	ng.two.datetimes.that.may.have.a
08e0	20 6e 65 67 6c 69 67 69 62 6c 65 20 64 69 66 66 65 72 65 6e 63 65 0a 20 20 20 20 74 6f 20 62 65	.negligible.difference.....to.be
0900	20 63 6f 6e 73 69 64 65 72 65 64 20 65 71 75 61 6c 2e 0a 20 20 20 20 29 01 da 03 61 62 73 29 04	.considered.equal......)...abs).
0920	da 03 64 74 31 da 03 64 74 32 da 05 64 65 6c 74 61 da 0a 64 69 66 66 65 72 65 6e 63 65 73 04 00	..dt1..dt2..delta..differences..
0940	00 00 20 20 20 20 72 0d 00 00 00 da 0c 77 69 74 68 69 6e 5f 64 65 6c 74 61 72 19 00 00 00 40 00	......r......within_deltar....@.
0960	00 00 73 3c 00 00 00 80 00 f5 0a 00 0d 10 90 05 89 4a 8c 4a 80 45 d8 11 14 90 73 91 19 80 4a d8	..s<.............J.J.E....s...J.
0980	0c 11 88 36 90 5a d0 0b 28 d0 0b 28 d2 0b 28 d0 0b 28 a0 35 d2 0b 28 d0 0b 28 d0 0b 28 d0 0b 28	...6.Z..(..(..(..(.5..(..(..(..(
09a0	d0 04 28 72 0f 00 00 00 29 01 4e 29 08 da 07 5f 5f 64 6f 63 5f 5f da 0a 5f 5f 66 75 74 75 72 65	..(r....).N)...__doc__..__future
09c0	5f 5f 72 03 00 00 00 72 04 00 00 00 72 05 00 00 00 72 0e 00 00 00 72 12 00 00 00 72 19 00 00 00	__r....r....r....r....r....r....
09e0	a9 00 72 0f 00 00 00 72 0d 00 00 00 fa 08 3c 6d 6f 64 75 6c 65 3e 72 1d 00 00 00 01 00 00 00 73	..r....r......<module>r........s
0a00	78 00 00 00 f0 03 01 01 01 f0 04 05 01 04 f0 00 05 01 04 f0 0c 00 01 28 d0 00 27 d0 00 27 d0 00	x......................(..'..'..
0a20	27 d0 00 27 d0 00 27 e0 00 23 d0 00 23 d0 00 23 d0 00 23 d0 00 23 d0 00 23 d0 00 23 d0 00 23 f0	'..'..'..#..#..#..#..#..#..#..#.
0a40	06 0d 01 3f f0 00 0d 01 3f f0 00 0d 01 3f f0 00 0d 01 3f f0 20 20 01 29 f0 00 20 01 29 f0 00 20	...?....?....?....?....)....)...
0a60	01 29 f0 46 01 07 01 29 f0 00 07 01 29 f0 00 07 01 29 f0 00 07 01 29 f0 00 07 01 29 72 0f 00 00	.).F...)....)....)....)....)r...
0a80	00	.