jellyfin-server/Emby.Server.Implementations/Activity/ActivityLogEntryPoint.cs

545 lines
21 KiB
C#
Raw Normal View History

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
2019-01-27 14:40:37 +00:00
using System.Threading.Tasks;
using MediaBrowser.Common.Configuration;
2014-08-10 22:13:17 +00:00
using MediaBrowser.Common.Plugins;
using MediaBrowser.Common.Updates;
using MediaBrowser.Controller;
using MediaBrowser.Controller.Authentication;
2014-08-10 22:13:17 +00:00
using MediaBrowser.Controller.Configuration;
using MediaBrowser.Controller.Devices;
2014-08-10 22:13:17 +00:00
using MediaBrowser.Controller.Entities;
using MediaBrowser.Controller.Library;
using MediaBrowser.Controller.Plugins;
using MediaBrowser.Controller.Session;
using MediaBrowser.Controller.Subtitles;
using MediaBrowser.Model.Activity;
using MediaBrowser.Model.Dto;
using MediaBrowser.Model.Entities;
2014-08-10 22:13:17 +00:00
using MediaBrowser.Model.Events;
2016-10-24 02:45:23 +00:00
using MediaBrowser.Model.Globalization;
2018-09-12 17:26:21 +00:00
using MediaBrowser.Model.Notifications;
using MediaBrowser.Model.Tasks;
using MediaBrowser.Model.Updates;
using Microsoft.Extensions.Logging;
2014-08-10 22:13:17 +00:00
2016-11-03 07:14:14 +00:00
namespace Emby.Server.Implementations.Activity
2014-08-10 22:13:17 +00:00
{
public class ActivityLogEntryPoint : IServerEntryPoint
{
private readonly IInstallationManager _installationManager;
private readonly ISessionManager _sessionManager;
private readonly ITaskManager _taskManager;
private readonly IActivityManager _activityManager;
private readonly ILocalizationManager _localization;
private readonly ILibraryManager _libraryManager;
private readonly ISubtitleManager _subManager;
private readonly IUserManager _userManager;
private readonly IServerConfigurationManager _config;
private readonly IServerApplicationHost _appHost;
2018-09-12 17:26:21 +00:00
private readonly IDeviceManager _deviceManager;
2014-08-10 22:13:17 +00:00
2018-09-12 17:26:21 +00:00
public ActivityLogEntryPoint(ISessionManager sessionManager, IDeviceManager deviceManager, ITaskManager taskManager, IActivityManager activityManager, ILocalizationManager localization, IInstallationManager installationManager, ILibraryManager libraryManager, ISubtitleManager subManager, IUserManager userManager, IServerConfigurationManager config, IServerApplicationHost appHost)
2014-08-10 22:13:17 +00:00
{
_sessionManager = sessionManager;
_taskManager = taskManager;
_activityManager = activityManager;
_localization = localization;
_installationManager = installationManager;
_libraryManager = libraryManager;
_subManager = subManager;
_userManager = userManager;
_config = config;
_appHost = appHost;
2018-09-12 17:26:21 +00:00
_deviceManager = deviceManager;
2014-08-10 22:13:17 +00:00
}
2019-01-27 14:40:37 +00:00
public Task RunAsync()
2014-08-10 22:13:17 +00:00
{
2019-02-28 21:33:20 +00:00
_taskManager.TaskCompleted += OnTaskCompleted;
2014-08-10 22:13:17 +00:00
2019-02-28 21:33:20 +00:00
_installationManager.PluginInstalled += OnPluginInstalled;
_installationManager.PluginUninstalled += OnPluginUninstalled;
_installationManager.PluginUpdated += OnPluginUpdated;
_installationManager.PackageInstallationFailed += OnPackageInstallationFailed;
2014-08-10 22:13:17 +00:00
2019-02-28 21:33:20 +00:00
_sessionManager.SessionStarted += OnSessionStarted;
_sessionManager.AuthenticationFailed += OnAuthenticationFailed;
_sessionManager.AuthenticationSucceeded += OnAuthenticationSucceeded;
_sessionManager.SessionEnded += OnSessionEnded;
2014-08-10 22:13:17 +00:00
2019-02-28 21:33:20 +00:00
_sessionManager.PlaybackStart += OnPlaybackStart;
_sessionManager.PlaybackStopped += OnPlaybackStopped;
2014-08-10 22:13:17 +00:00
2019-02-28 21:33:20 +00:00
_subManager.SubtitleDownloadFailure += OnSubtitleDownloadFailure;
2014-08-10 22:13:17 +00:00
2019-02-28 21:33:20 +00:00
_userManager.UserCreated += OnUserCreated;
_userManager.UserPasswordChanged += OnUserPasswordChanged;
_userManager.UserDeleted += OnUserDeleted;
_userManager.UserPolicyUpdated += OnUserPolicyUpdated;
_userManager.UserLockedOut += OnUserLockedOut;
2014-08-10 22:13:17 +00:00
2019-02-28 21:33:20 +00:00
_deviceManager.CameraImageUploaded += OnCameraImageUploaded;
2014-08-10 22:13:17 +00:00
2019-02-28 21:33:20 +00:00
_appHost.ApplicationUpdated += OnApplicationUpdated;
2019-01-27 14:40:37 +00:00
return Task.CompletedTask;
2014-08-10 22:13:17 +00:00
}
2019-02-28 21:33:20 +00:00
private void OnCameraImageUploaded(object sender, GenericEventArgs<CameraImageUploadInfo> e)
2018-09-12 17:26:21 +00:00
{
CreateLogEntry(new ActivityLogEntry
2018-09-12 17:26:21 +00:00
{
Name = string.Format(_localization.GetLocalizedString("CameraImageUploadedFrom"), e.Argument.Device.Name),
Type = NotificationType.CameraImageUploaded.ToString()
});
}
2019-02-28 21:33:20 +00:00
private void OnUserLockedOut(object sender, GenericEventArgs<User> e)
2015-03-02 05:16:29 +00:00
{
CreateLogEntry(new ActivityLogEntry
2015-03-02 05:16:29 +00:00
{
Name = string.Format(_localization.GetLocalizedString("UserLockedOutWithName"), e.Argument.Name),
2018-09-12 17:26:21 +00:00
Type = NotificationType.UserLockedOut.ToString(),
UserId = e.Argument.Id
2015-03-02 05:16:29 +00:00
});
}
2019-02-28 21:33:20 +00:00
private void OnSubtitleDownloadFailure(object sender, SubtitleDownloadFailureEventArgs e)
2014-08-10 22:13:17 +00:00
{
CreateLogEntry(new ActivityLogEntry
2014-08-10 22:13:17 +00:00
{
2018-09-12 17:26:21 +00:00
Name = string.Format(_localization.GetLocalizedString("SubtitleDownloadFailureFromForItem"), e.Provider, Notifications.Notifications.GetItemName(e.Item)),
2014-08-10 22:13:17 +00:00
Type = "SubtitleDownloadFailure",
ItemId = e.Item.Id.ToString("N"),
2018-09-12 17:26:21 +00:00
ShortOverview = e.Exception.Message
2014-08-10 22:13:17 +00:00
});
}
2019-02-28 21:33:20 +00:00
private void OnPlaybackStopped(object sender, PlaybackStopEventArgs e)
2014-08-10 22:13:17 +00:00
{
var item = e.MediaInfo;
if (item == null)
{
//_logger.LogWarning("PlaybackStopped reported with null media info.");
2014-08-10 22:13:17 +00:00
return;
}
2017-06-09 19:26:54 +00:00
if (e.Item != null && e.Item.IsThemeMedia)
2014-08-26 02:30:52 +00:00
{
// Don't report theme song or local trailer playback
return;
}
2014-08-26 02:30:52 +00:00
2014-08-10 22:13:17 +00:00
if (e.Users.Count == 0)
{
return;
}
2019-02-28 21:33:20 +00:00
var user = e.Users[0];
2014-08-10 22:13:17 +00:00
CreateLogEntry(new ActivityLogEntry
2014-08-10 22:13:17 +00:00
{
2018-09-12 17:26:21 +00:00
Name = string.Format(_localization.GetLocalizedString("UserStoppedPlayingItemWithValues"), user.Name, GetItemName(item), e.DeviceName),
Type = GetPlaybackStoppedNotificationType(item.MediaType),
UserId = user.Id
2014-08-10 22:13:17 +00:00
});
}
2019-02-28 21:33:20 +00:00
private void OnPlaybackStart(object sender, PlaybackProgressEventArgs e)
2014-08-10 22:13:17 +00:00
{
var item = e.MediaInfo;
if (item == null)
{
//_logger.LogWarning("PlaybackStart reported with null media info.");
2014-08-10 22:13:17 +00:00
return;
}
2017-06-09 19:26:54 +00:00
if (e.Item != null && e.Item.IsThemeMedia)
2014-08-26 02:30:52 +00:00
{
// Don't report theme song or local trailer playback
return;
}
2014-08-10 22:13:17 +00:00
if (e.Users.Count == 0)
{
return;
}
2014-10-02 00:28:16 +00:00
var user = e.Users.First();
2014-08-10 22:13:17 +00:00
CreateLogEntry(new ActivityLogEntry
2014-08-10 22:13:17 +00:00
{
2018-09-12 17:26:21 +00:00
Name = string.Format(_localization.GetLocalizedString("UserStartedPlayingItemWithValues"), user.Name, GetItemName(item), e.DeviceName),
Type = GetPlaybackNotificationType(item.MediaType),
UserId = user.Id
2014-08-10 22:13:17 +00:00
});
}
2018-09-12 17:26:21 +00:00
private static string GetItemName(BaseItemDto item)
{
var name = item.Name;
if (!string.IsNullOrEmpty(item.SeriesName))
{
name = item.SeriesName + " - " + name;
}
if (item.Artists != null && item.Artists.Length > 0)
{
name = item.Artists[0] + " - " + name;
}
return name;
}
private static string GetPlaybackNotificationType(string mediaType)
2018-09-12 17:26:21 +00:00
{
if (string.Equals(mediaType, MediaType.Audio, StringComparison.OrdinalIgnoreCase))
{
return NotificationType.AudioPlayback.ToString();
}
if (string.Equals(mediaType, MediaType.Video, StringComparison.OrdinalIgnoreCase))
{
return NotificationType.VideoPlayback.ToString();
}
return null;
}
private static string GetPlaybackStoppedNotificationType(string mediaType)
2018-09-12 17:26:21 +00:00
{
if (string.Equals(mediaType, MediaType.Audio, StringComparison.OrdinalIgnoreCase))
{
return NotificationType.AudioPlaybackStopped.ToString();
}
if (string.Equals(mediaType, MediaType.Video, StringComparison.OrdinalIgnoreCase))
{
return NotificationType.VideoPlaybackStopped.ToString();
}
return null;
}
2019-02-28 21:33:20 +00:00
private void OnSessionEnded(object sender, SessionEventArgs e)
2014-08-10 22:13:17 +00:00
{
string name;
var session = e.SessionInfo;
2018-09-12 17:26:21 +00:00
if (string.IsNullOrEmpty(session.UserName))
2014-08-10 22:13:17 +00:00
{
name = string.Format(_localization.GetLocalizedString("DeviceOfflineWithName"), session.DeviceName);
2014-08-14 13:24:30 +00:00
// Causing too much spam for now
return;
2014-08-10 22:13:17 +00:00
}
else
{
name = string.Format(_localization.GetLocalizedString("UserOfflineFromDevice"), session.UserName, session.DeviceName);
}
CreateLogEntry(new ActivityLogEntry
2014-08-10 22:13:17 +00:00
{
Name = name,
Type = "SessionEnded",
2014-10-02 00:28:16 +00:00
ShortOverview = string.Format(_localization.GetLocalizedString("LabelIpAddressValue"), session.RemoteEndPoint),
2018-09-12 17:26:21 +00:00
UserId = session.UserId
2014-08-10 22:13:17 +00:00
});
}
2019-02-28 21:33:20 +00:00
private void OnAuthenticationSucceeded(object sender, GenericEventArgs<AuthenticationResult> e)
2014-08-10 22:13:17 +00:00
{
2018-09-12 17:26:21 +00:00
var user = e.Argument.User;
CreateLogEntry(new ActivityLogEntry
2014-08-10 22:13:17 +00:00
{
2018-09-12 17:26:21 +00:00
Name = string.Format(_localization.GetLocalizedString("AuthenticationSucceededWithUserName"), user.Name),
2014-08-11 14:15:53 +00:00
Type = "AuthenticationSucceeded",
2018-09-12 17:26:21 +00:00
ShortOverview = string.Format(_localization.GetLocalizedString("LabelIpAddressValue"), e.Argument.SessionInfo.RemoteEndPoint),
UserId = user.Id
2014-08-10 22:13:17 +00:00
});
}
2019-02-28 21:33:20 +00:00
private void OnAuthenticationFailed(object sender, GenericEventArgs<AuthenticationRequest> e)
2014-08-10 22:13:17 +00:00
{
CreateLogEntry(new ActivityLogEntry
2014-08-10 22:13:17 +00:00
{
Name = string.Format(_localization.GetLocalizedString("FailedLoginAttemptWithUserName"), e.Argument.Username),
2014-08-11 14:15:53 +00:00
Type = "AuthenticationFailed",
2014-08-11 23:41:11 +00:00
ShortOverview = string.Format(_localization.GetLocalizedString("LabelIpAddressValue"), e.Argument.RemoteEndPoint),
Severity = LogLevel.Error
2014-08-10 22:13:17 +00:00
});
}
2019-02-28 21:33:20 +00:00
private void OnApplicationUpdated(object sender, GenericEventArgs<PackageVersionInfo> e)
2014-08-10 22:13:17 +00:00
{
CreateLogEntry(new ActivityLogEntry
2014-08-10 22:13:17 +00:00
{
2018-09-12 17:26:21 +00:00
Name = string.Format(_localization.GetLocalizedString("MessageApplicationUpdatedTo"), e.Argument.versionStr),
Type = NotificationType.ApplicationUpdateInstalled.ToString(),
2014-08-10 22:13:17 +00:00
Overview = e.Argument.description
});
}
2019-02-28 21:33:20 +00:00
private void OnUserPolicyUpdated(object sender, GenericEventArgs<User> e)
2014-08-10 22:13:17 +00:00
{
CreateLogEntry(new ActivityLogEntry
2014-08-10 22:13:17 +00:00
{
2018-09-12 17:26:21 +00:00
Name = string.Format(_localization.GetLocalizedString("UserPolicyUpdatedWithName"), e.Argument.Name),
Type = "UserPolicyUpdated",
UserId = e.Argument.Id
2014-08-10 22:13:17 +00:00
});
}
2019-02-28 21:33:20 +00:00
private void OnUserDeleted(object sender, GenericEventArgs<User> e)
2014-08-10 22:13:17 +00:00
{
CreateLogEntry(new ActivityLogEntry
2014-08-10 22:13:17 +00:00
{
Name = string.Format(_localization.GetLocalizedString("UserDeletedWithName"), e.Argument.Name),
Type = "UserDeleted"
});
}
2019-02-28 21:33:20 +00:00
private void OnUserPasswordChanged(object sender, GenericEventArgs<User> e)
2014-08-10 22:13:17 +00:00
{
CreateLogEntry(new ActivityLogEntry
2014-08-10 22:13:17 +00:00
{
Name = string.Format(_localization.GetLocalizedString("UserPasswordChangedWithName"), e.Argument.Name),
2014-10-02 00:28:16 +00:00
Type = "UserPasswordChanged",
2018-09-12 17:26:21 +00:00
UserId = e.Argument.Id
2014-08-10 22:13:17 +00:00
});
}
2019-02-28 21:33:20 +00:00
private void OnUserCreated(object sender, GenericEventArgs<User> e)
2014-08-10 22:13:17 +00:00
{
CreateLogEntry(new ActivityLogEntry
2014-08-10 22:13:17 +00:00
{
Name = string.Format(_localization.GetLocalizedString("UserCreatedWithName"), e.Argument.Name),
2014-10-02 00:28:16 +00:00
Type = "UserCreated",
2018-09-12 17:26:21 +00:00
UserId = e.Argument.Id
2014-08-10 22:13:17 +00:00
});
}
2019-02-28 21:33:20 +00:00
private void OnSessionStarted(object sender, SessionEventArgs e)
2014-08-10 22:13:17 +00:00
{
string name;
var session = e.SessionInfo;
2018-09-12 17:26:21 +00:00
if (string.IsNullOrEmpty(session.UserName))
2014-08-10 22:13:17 +00:00
{
name = string.Format(_localization.GetLocalizedString("DeviceOnlineWithName"), session.DeviceName);
2014-08-14 13:24:30 +00:00
// Causing too much spam for now
return;
2014-08-10 22:13:17 +00:00
}
else
{
name = string.Format(_localization.GetLocalizedString("UserOnlineFromDevice"), session.UserName, session.DeviceName);
}
CreateLogEntry(new ActivityLogEntry
2014-08-10 22:13:17 +00:00
{
Name = name,
Type = "SessionStarted",
2014-10-02 00:28:16 +00:00
ShortOverview = string.Format(_localization.GetLocalizedString("LabelIpAddressValue"), session.RemoteEndPoint),
2018-09-12 17:26:21 +00:00
UserId = session.UserId
2014-08-10 22:13:17 +00:00
});
}
2019-02-28 21:33:20 +00:00
private void OnPluginUpdated(object sender, GenericEventArgs<Tuple<IPlugin, PackageVersionInfo>> e)
2014-08-10 22:13:17 +00:00
{
CreateLogEntry(new ActivityLogEntry
2014-08-10 22:13:17 +00:00
{
Name = string.Format(_localization.GetLocalizedString("PluginUpdatedWithName"), e.Argument.Item1.Name),
2018-09-12 17:26:21 +00:00
Type = NotificationType.PluginUpdateInstalled.ToString(),
2014-08-10 22:13:17 +00:00
ShortOverview = string.Format(_localization.GetLocalizedString("VersionNumber"), e.Argument.Item2.versionStr),
Overview = e.Argument.Item2.description
});
}
2019-02-28 21:33:20 +00:00
private void OnPluginUninstalled(object sender, GenericEventArgs<IPlugin> e)
2014-08-10 22:13:17 +00:00
{
CreateLogEntry(new ActivityLogEntry
2014-08-10 22:13:17 +00:00
{
Name = string.Format(_localization.GetLocalizedString("PluginUninstalledWithName"), e.Argument.Name),
2018-09-12 17:26:21 +00:00
Type = NotificationType.PluginUninstalled.ToString()
2014-08-10 22:13:17 +00:00
});
}
2019-02-28 21:33:20 +00:00
private void OnPluginInstalled(object sender, GenericEventArgs<PackageVersionInfo> e)
2014-08-10 22:13:17 +00:00
{
CreateLogEntry(new ActivityLogEntry
2014-08-10 22:13:17 +00:00
{
Name = string.Format(_localization.GetLocalizedString("PluginInstalledWithName"), e.Argument.name),
2018-09-12 17:26:21 +00:00
Type = NotificationType.PluginInstalled.ToString(),
2014-08-10 22:13:17 +00:00
ShortOverview = string.Format(_localization.GetLocalizedString("VersionNumber"), e.Argument.versionStr)
});
}
2019-02-28 21:33:20 +00:00
private void OnPackageInstallationFailed(object sender, InstallationFailedEventArgs e)
2014-08-10 22:13:17 +00:00
{
2018-09-12 17:26:21 +00:00
var installationInfo = e.InstallationInfo;
2014-08-10 22:13:17 +00:00
CreateLogEntry(new ActivityLogEntry
2014-08-10 22:13:17 +00:00
{
2018-09-12 17:26:21 +00:00
Name = string.Format(_localization.GetLocalizedString("NameInstallFailed"), installationInfo.Name),
Type = NotificationType.InstallationFailed.ToString(),
ShortOverview = string.Format(_localization.GetLocalizedString("VersionNumber"), installationInfo.Version),
Overview = e.Exception.Message
2014-08-10 22:13:17 +00:00
});
}
2019-02-28 21:33:20 +00:00
private void OnTaskCompleted(object sender, TaskCompletionEventArgs e)
2014-08-10 22:13:17 +00:00
{
var result = e.Result;
var task = e.Task;
var activityTask = task.ScheduledTask as IConfigurableScheduledTask;
if (activityTask != null && !activityTask.IsLogged)
2014-08-10 22:13:17 +00:00
{
return;
}
2014-08-10 22:13:17 +00:00
var time = result.EndTimeUtc - result.StartTimeUtc;
var runningTime = string.Format(_localization.GetLocalizedString("LabelRunningTimeValue"), ToUserFriendlyString(time));
2014-10-24 04:54:35 +00:00
if (result.Status == TaskCompletionStatus.Failed)
2014-08-10 22:13:17 +00:00
{
var vals = new List<string>();
2018-09-12 17:26:21 +00:00
if (!string.IsNullOrEmpty(e.Result.ErrorMessage))
2014-08-10 22:13:17 +00:00
{
vals.Add(e.Result.ErrorMessage);
}
2018-09-12 17:26:21 +00:00
if (!string.IsNullOrEmpty(e.Result.LongErrorMessage))
2014-08-10 22:13:17 +00:00
{
vals.Add(e.Result.LongErrorMessage);
}
CreateLogEntry(new ActivityLogEntry
2014-08-10 22:13:17 +00:00
{
Name = string.Format(_localization.GetLocalizedString("ScheduledTaskFailedWithName"), task.Name),
2018-09-12 17:26:21 +00:00
Type = NotificationType.TaskFailed.ToString(),
2018-12-28 15:48:26 +00:00
Overview = string.Join(Environment.NewLine, vals.ToArray()),
2014-08-11 23:41:11 +00:00
ShortOverview = runningTime,
Severity = LogLevel.Error
2014-08-10 22:13:17 +00:00
});
}
}
private void CreateLogEntry(ActivityLogEntry entry)
2019-02-28 21:33:20 +00:00
=> _activityManager.Create(entry);
2014-08-10 22:13:17 +00:00
public void Dispose()
{
2019-02-28 21:33:20 +00:00
_taskManager.TaskCompleted -= OnTaskCompleted;
2014-08-10 22:13:17 +00:00
2019-02-28 21:33:20 +00:00
_installationManager.PluginInstalled -= OnPluginInstalled;
_installationManager.PluginUninstalled -= OnPluginUninstalled;
_installationManager.PluginUpdated -= OnPluginUpdated;
_installationManager.PackageInstallationFailed -= OnPackageInstallationFailed;
2014-08-10 22:13:17 +00:00
2019-02-28 21:33:20 +00:00
_sessionManager.SessionStarted -= OnSessionStarted;
_sessionManager.AuthenticationFailed -= OnAuthenticationFailed;
_sessionManager.AuthenticationSucceeded -= OnAuthenticationSucceeded;
_sessionManager.SessionEnded -= OnSessionEnded;
2014-08-10 22:13:17 +00:00
2019-02-28 21:33:20 +00:00
_sessionManager.PlaybackStart -= OnPlaybackStart;
_sessionManager.PlaybackStopped -= OnPlaybackStopped;
2014-08-10 22:13:17 +00:00
2019-02-28 21:33:20 +00:00
_subManager.SubtitleDownloadFailure -= OnSubtitleDownloadFailure;
2014-08-10 22:13:17 +00:00
2019-02-28 21:33:20 +00:00
_userManager.UserCreated -= OnUserCreated;
_userManager.UserPasswordChanged -= OnUserPasswordChanged;
_userManager.UserDeleted -= OnUserDeleted;
_userManager.UserPolicyUpdated -= OnUserPolicyUpdated;
_userManager.UserLockedOut -= OnUserLockedOut;
2014-08-10 22:13:17 +00:00
2019-02-28 21:33:20 +00:00
_deviceManager.CameraImageUploaded -= OnCameraImageUploaded;
2014-08-10 22:13:17 +00:00
2019-02-28 21:33:20 +00:00
_appHost.ApplicationUpdated -= OnApplicationUpdated;
2014-08-10 22:13:17 +00:00
}
/// <summary>
/// Constructs a user-friendly string for this TimeSpan instance.
/// </summary>
public static string ToUserFriendlyString(TimeSpan span)
{
const int DaysInYear = 365;
const int DaysInMonth = 30;
// Get each non-zero value from TimeSpan component
2019-01-13 20:37:13 +00:00
var values = new List<string>();
2014-08-10 22:13:17 +00:00
// Number of years
int days = span.Days;
if (days >= DaysInYear)
{
2016-03-27 21:11:27 +00:00
int years = days / DaysInYear;
2014-08-10 22:13:17 +00:00
values.Add(CreateValueString(years, "year"));
2016-03-27 21:11:27 +00:00
days = days % DaysInYear;
2014-08-10 22:13:17 +00:00
}
2019-02-28 21:33:20 +00:00
2014-08-10 22:13:17 +00:00
// Number of months
if (days >= DaysInMonth)
{
2016-03-27 21:11:27 +00:00
int months = days / DaysInMonth;
2014-08-10 22:13:17 +00:00
values.Add(CreateValueString(months, "month"));
2016-03-27 21:11:27 +00:00
days = days % DaysInMonth;
2014-08-10 22:13:17 +00:00
}
2019-02-28 21:33:20 +00:00
2014-08-10 22:13:17 +00:00
// Number of days
if (days >= 1)
2019-02-28 21:33:20 +00:00
{
2014-08-10 22:13:17 +00:00
values.Add(CreateValueString(days, "day"));
2019-02-28 21:33:20 +00:00
}
2014-08-10 22:13:17 +00:00
// Number of hours
if (span.Hours >= 1)
2019-02-28 21:33:20 +00:00
{
2014-08-10 22:13:17 +00:00
values.Add(CreateValueString(span.Hours, "hour"));
2019-02-28 21:33:20 +00:00
}
2014-08-10 22:13:17 +00:00
// Number of minutes
if (span.Minutes >= 1)
2019-02-28 21:33:20 +00:00
{
2014-08-10 22:13:17 +00:00
values.Add(CreateValueString(span.Minutes, "minute"));
2019-02-28 21:33:20 +00:00
}
2014-08-10 22:13:17 +00:00
// Number of seconds (include when 0 if no other components included)
if (span.Seconds >= 1 || values.Count == 0)
2019-02-28 21:33:20 +00:00
{
2014-08-10 22:13:17 +00:00
values.Add(CreateValueString(span.Seconds, "second"));
2019-02-28 21:33:20 +00:00
}
2014-08-10 22:13:17 +00:00
// Combine values into string
2019-01-13 20:37:13 +00:00
var builder = new StringBuilder();
2014-08-10 22:13:17 +00:00
for (int i = 0; i < values.Count; i++)
{
if (builder.Length > 0)
2019-02-28 21:33:20 +00:00
{
2016-03-27 21:11:27 +00:00
builder.Append(i == values.Count - 1 ? " and " : ", ");
2019-02-28 21:33:20 +00:00
}
2014-08-10 22:13:17 +00:00
builder.Append(values[i]);
}
// Return result
return builder.ToString();
}
/// <summary>
/// Constructs a string description of a time-span value.
/// </summary>
/// <param name="value">The value of this item</param>
/// <param name="description">The name of this item (singular form)</param>
private static string CreateValueString(int value, string description)
{
return string.Format("{0:#,##0} {1}",
value, value == 1 ? description : string.Format("{0}s", description));
2014-08-10 22:13:17 +00:00
}
}
}