hms

hms

Aperçu

Le package hms fournit une classe simple pour stocker des durées ou des valeurs d'heure et les afficher au format hh:mm:ss. Cette classe est destinée à simplifier l'échange de données avec des bases de données, des feuilles de calcul et d'autres sources de données :

• Stocke les valeurs sous forme de vecteur numérique contenant le nombre de secondes écoulées depuis minuit
• Prend en charge la construction à partir de valeurs explicites d'heure, de minute ou de seconde
• Prend en charge la coercition vers et depuis divers types de données, y compris POSIXt
• Peut être utilisé comme colonne dans un bloc de données
• Basé sur la classe difftime
• Les valeurs peuvent dépasser la limite de 24 heures ou être négatives
• Par défaut, les fractions de secondes jusqu'à la microseconde sont affichées, quelle que soit la valeur de l'option "digits.secs"

Installation

 # Le moyen le plus simple d'obtenir hms est d'installer l'intégralité du Tidyverse :
install.packages ( "tidyverse" )

# Alternativement, installez simplement hms :
install.packages ( "hms" )

# Ou la version de développement de GitHub :
# install.packages("outils de développement")
devtools :: install_github ( "tidyverse/hms" )

Usage

L'exemple suivant montre les manières d'utiliser la classe hms de manière autonome ou en tant que colonne de bloc de données.

 bibliothèque ( hms )

hms ( 56 , 34 , 12 )
#> 12:34:56
as_hms ( Sys.time ( ) )
#> 11:55:02.553476
parse_hms ( "12:34:56" )
#> 12:34:56
as.POSIXct ( hms ( 1 ) )
#> [1] "01/01/1970 00:00:01 UTC"

data.frame ( heures = 1 : 3 , hms = hms ( heures = 1 : 3 ) )
#> heures hms
#> 1 1 01:00:00
#> 2 2 02:00:00
#> 3 3 03:00:00

Représentation interne

Les objets du hms et de ses classes difftime sous-jacentes sont stockés en nombre de secondes depuis 00:00:00 . Utilisez as.numeric() et as_hms() pour convertir vers et depuis des nombres.

 fois <- parse_hms ( c ( "00:00:00.25" , "00:00:01" , "00:01:30" , "01:00:00" ) )
fois
#> 00:00:00.25
#> 00:00:01.00
#> 00:01:30.00
#> 01:00:00.00
times_num <- as.numeric ( fois )
nombre_fois
#> [1] 0,25 1,00 90,00 3600,00
as_hms ( num_fois )
#> 00:00:00.25
#> 00:00:01.00
#> 00:01:30.00
#> 01:00:00.00

---

Veuillez noter que le projet « hms » est publié avec un code de conduite des contributeurs. En contribuant à ce projet, vous acceptez d'en respecter les termes.

Développer