R语言 xts包 .parseISO8601()函数中文帮助文档(中英文对照)

loveR

.parseISO8601(xts)
.parseISO8601()所属R语言包：xts

                                         Internal ISO 8601:2004(e) Time Parser
                                         时间解析器内部ISO 8601:2004（E）

                                         译者：生物统计家园网 机器人LoveR

描述----------Description----------

This function is used internally in the subsetting mechanism of xts.  The function is unexported, though documented for use with xts subsetting.
此功能是在内部使用的子集机制的XTS。该函数导出，虽然为使用XTS子集的记录。


用法----------Usage----------


.parseISO8601(x, start, end, tz="")

.makeISO8601(x)



参数----------Arguments----------

参数：x
For .parseISO8601(x), a character string conforming  to the ISO 8601:2004(e) rules. For .makeISO8601(x), x should be a time-like object with start and end methods.  
对于。parseISO8601（x）的，符合的ISO 8601:2004（五）的规则的一个字符的字符串。 。makeISO8601（X），x应该是一个时间对象start和end方法。


参数：start
lower constraint on range  
约束范围


参数：end
upper constraint of range  
上约束范围


参数：tz
timezone (tzone) to use internally  
时区（tzone）在内部使用


Details

详细信息----------Details----------

This function replicates most of the ISO  standard for expressing time and time-based ranges in a universally accepted way.
此功能复制的ISO标准中的一个普遍接受的方式来表达时间和基于时间的范围。

The best documentation is now the official ISO page as well as the Wikipedia entry for ISO 8601:2004.
最佳文档，现在是正式的ISO页的维基百科条目以及ISO 8601:2004。

The basic idea is to create the endpoints of a range, given a string representation. These endpoints are aligned in POSIXct time to the zero second of the day at the beginning, and the 59.9999th second of the 59th minute of the 23rd hour of the final day.
基本的想法是创建的端点的范围内，给定的字符串表示。这些的端点对齐POSIXct时间零十二之天开始，59.9999th第59分钟，第二次23小时的最后一天。

For dates prior to the epoch (1970-01-01) the ending time is aligned to the 59.0000 second. This is due to a bug/feature in the R implementation of asPOSIXct and mktime0 at the C-source level. This limits the precision of ranges prior to 1970 to 1 minute granularity with the current xts workaround.
对于日期之前的时代（1970-01-01）结束的时间是一致的59.0000秒。这是因为一个bug /功能的C源代码级的R实现的asPOSIXct和mktime0。这限制范围的精度与当前xts解决办法之前，1970年为1分钟的间隔。

Recurring times over multiple days may be specified using the T notation. See the examples for details.
重复时间多天，可以指定使用的T符号。的详细信息，请参阅的例子。


值----------Value----------

A list of length two, with an entry named "first.time" and one names "last.time".
列表的长度为2，同一个项目，名为“first.time和1名”last.time，“。

For .makeISO8601, a character vector of length one describing the ISO-style format for a given time-based object.
对于makeISO8601，字符向量的长度描述了ISO-风格的格式，对于一个给定的时间为基础的物件。


注意----------Note----------

There is no checking done to test for a properly constructed ISO format string.  This must be correctly entered by the user, lest bad things may happen.
有没有做正确的ISO格式字符串测试检查。这必须正确地输入了用户，以免不好的事情可能会发生。

When using durations, it is important to note that the time of the duration specified is not necessarily the same as the realized periods that may be returned when applied to an irregular time series.  This is not a bug, rather it is a standards and implementation gotcha.
当使用持续时间，重要的是要注意，指定的持续时间的时间是施加到一个不规则的时间序列时，可以返回作为实现期间不一定是相同的。这是不是一个错误，而是一个标准和实施疑难杂症。


（作者）----------Author(s)----------



Jeffrey A. Ryan




参考文献----------References----------

http://www.iso.org/iso/support/faqs/faqs_widely_used_standards/widely_used_standards_other/date_and_time_format.htm

实例----------Examples----------


# the start and end of 2000[2000年的开始和结束]
.parseISO8601('2000')

# the start of 2000 and end of 2001[2000年和2001年年底开始]
.parseISO8601('2000/2001')

# May 1, 2000 to Dec 31, 2001[2000年5月1日至2001年12月31号]
.parseISO8601('2000-05/2001')

# May 1, 2000 to end of Feb 2001[2000年5月1日至2001年2月结束]
.parseISO8601('2000-05/2001-02')

# Jan 1, 2000 to Feb 29, 2000; note the truncated time on the LHS[2000年1月1日至2000年2月29日;注意截断的LHS]
.parseISO8601('2000-01/02')

# 8:30 to 15:00 (used in xts subsetting to extract recurring times)[8:30至15:00（XTS子集提取重复时间）]
.parseISO8601('T08:30/T15:00')

转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。


注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。
转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。


注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。