screen_duration: Screen duration by hour or day

In mpathsenser: Process and Analyse Data from m-Path Sense

Screen duration by hour or day

Description

Calculate the screen duration time where the screen was unlocked (i.e. not just on).

Usage

screen_duration(
  db,
  participant_id,
  start_date = NULL,
  end_date = NULL,
  by = c("Hour", "Day")
)

Arguments

db	A database connection to an m-Path Sense database.
participant_id	A character string identifying a single participant. Use get_participants to retrieve all participants from the database. Leave empty to get data for all participants.
start_date	Optional search window specifying date where to begin search. Must be convertible to date using as.Date. Use first_date to find the date of the first entry for a participant.
end_date	Optional search window specifying date where to end search. Must be convertible to date using as.Date. Use last_date to find the date of the last entry for a participant.
by	Either 'Hour' or 'Day' indicating how to summarise the results. Leave empty to get raw screen duration per measurement.

Value

A tibble with either 'hour' and 'duration' columns or 'date' and 'duration' columns depending on the by argument. Alternatively, if no by is specified, a remote tibble is returned with the date, time, and duration since the previous measurement.

mpathsenser documentation built on May 29, 2024, 9:11 a.m.