NHL Edge Skater Zone Time — nhl_edge_skater_zone

Returns the NHL Edge zone-time payload (offensive, defensive, neutral) for a single skater. Wraps https://api-web.nhle.com/v1/edge/skater-zone-time/{playerId}/.... When season is NULL (default) the /now endpoint is used to fetch the current season.

Usage

nhl_edge_skater_zone_time(player_id, season = NULL, game_type = 2)

Arguments

player_id: Integer NHL player ID (e.g., 8478402 for Connor McDavid).
season: Optional 4-digit end-year (e.g., 2025 for the 2024-25 season), an 8-character API season (e.g., "20242025"), or NULL (default) for the current season via the /now endpoint.
game_type: Integer game type. 1 = preseason, 2 = regular season (default), 3 = playoffs.

Value

A data frame (fastRhockey_data) with the following columns:

col_name	types	description
strength_code	character	Strength state code (e.g., all, even, pp, pk).
offensive_zone_pctg	numeric	Percentage of time in the offensive zone.
offensive_zone_percentile	numeric	League percentile rank for offensive-zone time.
offensive_zone_league_avg	numeric	League average offensive-zone time percentage.
neutral_zone_pctg	numeric	Percentage of time in the neutral zone.
neutral_zone_percentile	numeric	League percentile rank for neutral-zone time.
neutral_zone_league_avg	numeric	League average neutral-zone time percentage.
defensive_zone_pctg	numeric	Percentage of time in the defensive zone.
defensive_zone_percentile	numeric	League percentile rank for defensive-zone time.
defensive_zone_league_avg	numeric	League average defensive-zone time percentage.

Examples

# \donttest{
  try(nhl_edge_skater_zone_time(player_id = 8478402))
#> ── NHL Edge Skater Zone Time ────────────────────────────── fastRhockey 1.0.0 ──
#> ℹ Data updated: 2026-06-13 03:25:09 UTC
#> # A tibble: 4 × 10
#>   strength_code offensive_zone_pctg offensive_zone_percentile
#>   <chr>                       <dbl>                     <dbl>
#> 1 all                         0.456                     0.817
#> 2 es                          0.434                     0.759
#> 3 pp                          0.644                     0.842
#> 4 pk                          0.280                     0.495
#> # ℹ 7 more variables: offensive_zone_league_avg <dbl>, neutral_zone_pctg <dbl>,
#> #   neutral_zone_percentile <dbl>, neutral_zone_league_avg <dbl>,
#> #   defensive_zone_pctg <dbl>, defensive_zone_percentile <dbl>,
#> #   defensive_zone_league_avg <dbl>
# }